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内 容 所 要 


本 书 全 面 介 绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概念 ， 并 详 
细 讲 解 如 何 运用 现代 设计 原则 使 用 Go 语言 构建 Web 应 用 。 本 书 通 过 大 量 
的 实例 介绍 核心 概念 《如 处 理 请 求 和 发 送 啊 应 、 模 板 引 车 和 数据 持久 
化 ) ， 并 深入 讨论 更 多 高 级 主题 “如 并 发 、Web 应 用 程序 测试 以 及 部 闭 
到 标准 系统 服务 上 融和 PaaS 提 供 商 〉。 


本 书 以 一 个 网 络 论坛 为 例 ， 讲 解 如 何 使 用 请 求 处 理 器 、 多 路 复 用 
器 、 模 板 引 擎 、 存 储 系统 等 核心 组 件 构建 一 个 Go Web 应 用 ， 然 后 在 这 
一 应 用 的 基础 上 上， 构建 出 相应 的 web 服务 。 值 得 一 提 的 是 ， 本 书 在 介绍 
Go Web 开 发 方法 时 ， 基 本 上 只 用 到 Go 语言 自 带 的 标准 库 ， 而 不 会 用 到 
任何 特定 的 Web 框 架 ， 读 者 学 到 的 知识 将 不 会 局 限于 特定 的 框架 ， 即 使 
将 来 需要 用 到 现成 的 框架 或 者 自行 构建 框架 ， 仍 然 会 从 本 书 中 获 益 。 本 
书 除 了 讲解 具体 的 Web 开 发 方法 ， 还 介绍 如 何 对 Go Web 应 用 进行 测 
试 ， 如 何 使 用 Go 的 并 发 特性 提高 Web 应 用 的 性 能 ， 以 及 如 何在 Heroku、 
Google App Engine, Digital Ocean 等 云 平 台 上 部 署 Go WebM H; 此外， 
书 中 还 传授 一 些 Go Web 开 发 方面 的 经 验 和 提示 。 这 些 重 要 的 实践 知识 
将 帮助 读者 快速 成 为 真正 具有 生产 力 的 Go Web 开 发 者 。 


























阅读 本 书 需要 读者 具备 基本 的 Go 语言 编程 技能 并 掌握 Go 语言 的 语 
法 。 本 书 适合 所 有 想 用 Go 语言 进行 Web 开 发 的 读者 阅读 ， 无 论 是 Web 开 
发 的 初学 者 还 是 入 行 已 久 的 开 友 者 都 会 在 阅读 本 书 的 过 程 中 有 所 收获 。 


译 者 记事 





随 着 近年 来 Web 开 发 的 盛行 ， 很 多 相关 书籍 也 随 之 如 雨后春笋 般 出 
现 ， 然 而 在 这 些 书 籍 当中 ， 绝 大 多 数 书籍 都 只 关注 表面 的 实现 代码 ， 而 
对 代码 背后 的 技术 原理 却 少 有 提 及 。 读 者 在 看 这 类 书籍 时 ， 虽 然 可 以 学 
到 某 个 框架 或 者 某 个 库 的 API， 并 根据 书 中 给 出 的 代码 搭建 出 一 个 个 演 
示 程 序 (demo) ， 但 是 对 隐藏 在 这 些 代码 之 下 的 原理 却 一 无 所 知 。 这 
种 停留 在 表面 的 理解 一 旦 离开 了 书本 的 指导 ， 就 会 让 人 感到 寸步 难 行 ， 
不 知 所 措 。 


本 书 的 独特 之 处 在 于 ， 它 抛 开 了 现 有 的 所 有 Go Web 框 架 ， 仅 仅 通 
过 Go 语言 内 置 的 标准 库 来 展示 如 何 去 构 建 一 个 web 应 用 或 web 服务。 这 
样 做 的 好 处 是 ， 无 论 将 来 读者 是 使 用 这 些 标 准 库 来 构建 Web 应 用 ， 还 是 
使 用 现成 的 框架 去 构建 Web 应 用 ， 又 或 者 使 用 自己 建造 的 框架 去 构建 
Web 应 用 ， 本 书 介 绍 的 知识 都 是 非常 有 用 的 : 如 果 使 用 的 是 现成 的 框 
染 ， 那 么 这 些 框架 的 内 部 实现 通常 就 是 由 本 书 介绍 的 Go 标准 库 构 建 
Hy; 如 果 选 择 自 建 框架 ， 那 么 将 有 很 大 概率 会 用 到 本 书 介绍 的 Go 标准 
库 。 因 此 ， 不 论 在 何 种 情况 下 ， 本 书 对 于 构建 Go Web 应 用 都 是 非常 有 
帮助 的 。 





本 书 的 另 一 个 优点 是 ， 它 在 介绍 Web 应 用 开发 技术 的 同时 ， 也 介绍 
了 隐藏 在 这 些 技术 背后 的 基础 知识 。 比 如 ， 在 介绍 Web 处 理 器 
(handler) 的 创建 方法 之 前 ， 本 书 就 先 深 入 浅 出 地 介绍 了 HTTP 协 议 ， 
然后 才 说 明 具 体 的 请 求 处 理 方 法 以 及 啊 应 返回 方法 ; 又 比如 说 ， 在 介绍 





会 话 (session) 技术 时 ， 本 书 束 完 说 明了 HTTP 协 议 的 无 状态 性 质 ， 然 
后 才 说 明 如 何 使 用 会 话 去 解决 这 一 问题 ， 类 似 的 例子 在 书 里 面 还 有 很 
多 ， 不 一 而 足 。 对 刚 开 始 接触 web 开发 的 读者 来 说 ， 本 书 这 种 “ 知 其 
然 ， 也 知 其 所 以 然 ” 的 教授 方式 能 够 让 读者 打 好 Web 开 发 的 基础 ， 从 而 
达到 事半功倍 的 效果 ; 此 外 ， 对 那些 已 经 有 一 定 Web 开 发 经 验 的 读者 来 
说 ， 本 书 将 在 介绍 Go Web 开 及 方法 的 同时 ， 帮 助 读者 回顾 和 巩固 Web 
开发 的 相关 基础 知识 ， 并 厌 此 成 为 更 好 的 Web 开 发 者 。 


综 上 所 述 ， 我 认为 这 本 书 对 所 有 关心 Web 开 发 的 人 来 说 ， 都 是 非常 
值得 一 读 的 一 一 无 论 读者 使 用 的 是 Go 语言 还 是 其 他 语言 、X 框 架 还 是 Y 
框架 ， 无 论 读者 是 Web 开 发 的 初学 者 还 是 入 行 已 久 的 开发 者 ， 应 该 都 会 
在 阅读 本 书 的 过 程 中 有 所 收获 。 


关于 本 书 的 翻 详 


这 本 《Go Web 编 程 》 是 我 的 第 二 部 译作 ， 在 翻译 第 一 部 译作 
《Redis 实 战 》 的 时 候 ， 因 为 受 经 验 、 知 识 以 及 时 间 等 条 件 限 制 ， 我 只 
能 把 时 间 尺 量 花 在 保证 译文 的 准确 性 上 ， 但 是 对 于 译文 本 映 的 可 读 性 却 
未 能 有 太 多 的 关注 。 这 次 在 翻译 这 本 《Go Web 编 程 》 的 过 程 中 ， 我 给 
目 己 订立 了 更 高 的 目标 ， 那 就 是 ， 在 保证 译文 正确 性 的 前 提 下 ， 通 过 合 
理 的 用 词 址 句 ， 让 译文 更 符合 中 文 表达 方式 ， 并 且 更 具 表 现 力 。 


以 本 书 的 前 言 原文 为 例 ， 其 中 就 有 一 句 “My own journey in 
developing applications for the web started around the same time, in the mid- 
1990s”， 这 人 句 话 的 原意 是 说 作者 的 Web 开 发 生涯 跟 万 维 网 的 发 展 轨迹 下 
好 重合 ， 因 此 把 它 单纯 地 译 为 “本 人 的 Web 应 用 开发 生涯 也 是 从 20 世 纪 








90 年 代 中 期 开始 .………? 是 完全 没有 问题 的 ， 但 是 通过 在 句子 前 面 添加 “无 
AUS 183" — i8] 2K 5; "around the same time” 的 翻译 “也 是 ”相互 呼应 ， 就 会 一 
下 子 给 译文 币 来 画龙点睛 的 效果 :“ 无 独 有 偶 ， 本 人 的 Web 应 用 开发 生 
涯 也 是 从 20 世 纪 90 年 代 中 期 开始 .…....” 








继续 以 前 言 为 例 ， 在 这 篇 文章 的 原文 当中 ， 出 现 了 不 少 常见 的 瑞 文 
短语 和 词汇 ， 这 些 短语 和 词汇 通常 都 有 一 个 正确 、 第 见 并 且 平 良 的 翻 
译 ， 但 是 本 书 却 抛 痉 了 这 些 翻译 ， 转 而 选择 了 更 准确 也 更 有 表现 力 的 译 
法 。 比 如 说 , “Writing web applications has changed dramatically over the 
years” 中 的 “changed dramatically” 没 有 直译 为 “发 生 了 戏剧 性 的 变化 ”， 而 
是 翻译 为 “发 生 了 翻天 窗 地 的 变化 ”; “Almost as soon as the first web 
applications were written, web application frameworks appeared” 中 的 “were 
written” 和 “appeared” 没 有 直译 为 “被 编写 出 来 之 后 ”以 及 “出 现 ”， 而 是 分 
别 翻 译 为 “内 亮 登 场 ? 和 “应 运 而 生 ”， 前 者 突出 了 Web 应 用 的 出 现 对 于 互 
联网 的 巨大 改变 ， 而 后 者 则 突出 了 Web 应 用 和 Web 框 架 之 间 相 辅 相 成 的 
关系 。 类 似 的 例 季 还 有 很 多 很 多 ， 并 且 它 们 不 仅 出 现在 了 前 言 里 ， 还 出 
现在 了 本 书 的 正文 当中 。 











当然 ， 提 高 译文 的 可 读 性 并 不 是 一 件 一 践 而 就 的 事 。 为 了 让 译文 更 
有 “中 文 味 ”， 本 书 的 大 多 数 译文 都 已 三 易 其 稿 ， 有 时 候 仅仅 为 了 挑选 出 
一 个 更 恰当 的 词语 或 成 语 ， 就 不 得 不 对 着 词典 推 各 半天 。 这 本 书 的 翻译 
从 2016 年 8 月 开始 ， 到 2017 年 8 月 交 稳 ， 整 整 跨越 了 一 年 时 间 ， 其 中 翻译 
原文 和 润色 译文 两 项 工作 花费 的 时 间 可 谓 各 占 一 半 。 如 果 读 者 能 够 从 译 
文 的 字里行间 感受 到 这 种 润 物 细 无 声 的 优化 ， 那 将 是 对 本 人 翻译 工作 最 
好 的 肯定 。 








另外 ， 因 为 这 是 一 本 使 用 Go 语言 标准 库 进 行 Web 开 及 的 书 ， 所 以 对 
Go Web 开 发 相关 标准 库 的 理解 程度 将 是 能 个 准 确 地 翻译 本 书 技术 内 容 
的 关键 。 为 了 进一步 熟悉 本 书 用 到 的 标准 库 ， 本 人 通读 了 书 中 用 到 的 各 
个 标准 库 的 文档 ， 阅 读 了 其 中 部 分 标准 库 的 源码 ， 并 且 因 为 有 时 候 “ 好 
记性 比 不 上 烂 笔 头 ”， 上 所 以 本 人 还 翻译 了 其 中 一 部 分 标准 库 文 要 ， 力 求 
在 尽 可 能 掌握 标准 库 细 市 的 情况 下 ， 再 进行 翻译 ， 尽 量 做 到 知 其 然 也 知 
其 所 以 然 ， 而 不 是 单纯 地 根据 纸 面 上 的 文字 和 代码 进行 翻译 。 

















最 后 ， 在 翻译 本 书 的 过 程 中 ， 本 人 也 发 现 了 原著 中 大 大 小 小 数 十 个 
bug， 并 在 译文 中 一 一 进行 了 修正 。 综 上 所 述 ， 读 者 看 到 的 这 个 译本 从 
菏 个 角度 来 说 将 比 原 车 更 准确 也 更 易 读 。 这 也 是 我 一 直 以 来 在 实践 翻译 
工作 时 的 信念 一 一 译作 不 应 该 是 原著 的 “劣化 版 ”， 而 是 应 该 以 * 育 出 于 
蓝 而 胜 于 蓝 ” 的 方式 超越 原 善 。 当 然 ， 要 做 到 这 一 点 并 不 是 一 件 容易 的 
事 ， 但 每 一 个 合格 的 译 者 都 应 该 以 此 为 目标 ， 不 断 否 斗 。 





读者 服务 网 站 


为 了 更 好 地 服务 本 书 读者 ， 本 人 专门 为 本 书 搭建 了 读者 服务 网 站 
http://gwpcn.com。 读 者 只 要 访问 这 个 网 站 ， 束 可 以 查看 到 与 本 书 有 关 的 
各 项 信息 ， 如 本 书 的 简介 、 目 录 、 试 读 内 容 、 作 译 者 介绍 、 勤 误 信 息 、 
购买 地 址 以 及 源 代 码 下 载 地 址 等 。 


除 此 之 外 ， 正 如 之 前 所 说 ， 本 人 在 翻译 本 书 的 过 程 中 也 翻译 了 一 部 
分 Go 标准 库 的 文档 ， 这 些 文档 可 以 通过 地 址 http://cngolib.com 查 看 。 
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《Redis 设 计 与 实现 》 一 书 的 作者 ，《Redis 实 战 》 一 书 的 译 者 。 





除了 已 出 版 的 两 本 作品 之 外 ， 他 还 创作 和 翻译 了 《Go 标准 库 中 文 
L) 《Redis 命 令 参考 》 《SICP 解 题 集 》 等 一 系列 开源 文档 。 


要 了 解 关于 黄 健 宏 的 更 多 信息 ， 请 访问 他 的 个 人 主页 
http://huangz.me. 
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自 互 联网 从 20 世 纪 90 年 代 中 期 诞生 以 来 ，Web 应 用 就 以 这 样 或 那样 
的 方式 存在 了 。 昌 然 Web 应 用 在 最 初 只 能 传输 静态 网 页 ， 但 它 很 快 就 升 
级 和 演变 成 了 一 个 令 人 眼花 综 乱 、 能 够 传输 各 种 数据 以 及 实现 各 种 功能 
的 动态 系统 。 无 独 有 偶 ， 本 人 也 是 从 20 世 纪 90 年 代 中 期 开始 接触 web 应 
用 开发 的 ， 在 迄今 为 止 的 职业 生涯 当中 ， 我 把 大 部 分 时 间 都 花费 在 了 大 
规模 Web 应 用 的 设计 、 开 发 以 及 团队 管理 上 面 ， 并 且 在 这 期 间 还 使 用 过 
多 种 不 同 的 编程 语言 和 框架 ， 其 中 包括 Java、Ruby、Node.js、PHP、 
Perl、Elixir 甚 至 是 Smalltalk。 





几 年 前 ， 我 因为 一 次 偶然 的 机 会 接触 到 了 Go 语言 ， 并 迅速 被 它 的 
简单 和 清 更 直率 所 吸引 ， 而 当 我 意识 到 只 使 用 Go 的 标准 库 就 可 以 快速 
地 构建 完整 、 高 效 并 且 可 扩展 的 Web 应 用 和 服务 时 ， 我 对 Go 的 喜爱 又 更 
进 了 了 一步。 使 用 Go 语言 编写 的 代码 不 仅 易 履 、 和 直截了当 ， 而 且 还 能 够 
快速 、 简 单 地 编译 成 一 个 独立 的 可 部 普 二 进 制 文件 。 更 关键 的 是 ， 我 不 
必 投 入 大 量 服 务 器 就 可 以 让 上 自己 的 Web 应 用 变 得 可 扩展 且 有 具备 生 产能 
力 。 很 目 然 地 ， 所 有 的 这 些 优 点 都 使 Go 成 为 了 我 在 Web 应 用 开发 方面 最 
新 的 心头 好 语言 。 

















从 当初 传输 静态 内 容 到 现在 通过 HTTP 传 输 动 态 数据 ， 从 当初 使 用 
服务 器 传输 HTML 内容， 到 现在 使 用 客户 端 单 页 应 用 去 处 理 通过 HTTP 
传输 的 JSON 数 据 ，Web 应 用 的 开发 方式 已 经 发 生 了 翻天 履 地 的 变化 。 
几乎 就 在 Web 应 用 闪 亮 登场 的 同时 ，Web 框 架 也 应 运 而 生 ， 并 使 程序 员 





可 以 更 为 容易 地 去 开发 Web 应 用 。 这 二 十 多 年 以 来 ， 绝 大 多 数 编程 语言 
都 会 有 至少 一 个 Web 应 用 框架 ， 其 中 很 多 语言 甚至 会 有 一 大 堆 框 架 可 
用 ， 而 当今 出 现 的 绝 大 多 数 应 用 都 是 Web 应 用 。 








尽管 Web 应 用 框架 的 风靡 使 开发 Web 应 用 变 得 更 加 容易 了 ， 但 这 些 
框 染 在 带 来 方便 的 同时 也 隐藏 了 大 量 的 细 市 一 一 Web 应 用 开发 者 对 于 万 
维 网 的 运作 方式 知之 其 少 甚 至 一 窟 不 通 ， 这 样 的 情况 正在 变 得 越 来 越 第 
见 。 幸 运 的 是 ， 通 过 Go 语言 ， 我 发 现 了 一 种 正确 地 教授 Web 应 用 开发 基 
础 知识 的 绝 佳 工具 ， 它 能 够 让 Web 应 用 开发 重新 回 到 简单 直接 的 状态 : 
程序 需要 考虑 的 就 是 如 何 处 理 HTTP 协 议 ， 以 及 如 何 通 过 HTTP 协 议 传输 
内 容 和 数据 ， 并 且 满 足 这 两 个 要 求 只 需要 用 到 Go 语言 本 身 提供 的 工具 
一 一 个 需要 用 到 外 部 库 ， 也 不 需要 用 到 外 部 的 依赖 。 























在 拿 定 注意 之 后 ， 我 就 向 Manning 出 版 社 提交 了 一 个 撰写 Go 语言 编 
程 书籍 的 构思 ， 这 个 构思 关注 的 是 如 何在 只 使 用 标准 库 的 情况 下 ， 癌 读 
者 传授 从 零 开始 构建 Web 应 用 的 方法 ， 而 Manning 出 版 社 也 很 快 就 同意 
了 我 的 构思 并 开局 了 这 个 项 目 。 尽 管 本 书 的 撰写 工作 持续 了 一 段 时 间 才 
得 以 完成 ， 但 是 在 写作 的 过 程 中 ， 抢 先 预览 版 各 来 的 反馈 总 是 不 断 地 去 
舞 关 我。 最后， 我 希望 读者 能 够 像 我 译 受 创作 本 书 的 过 程 一 样 ， 有 至 受 阅 
读本 书 的 过 程 ， 并 且 在 这 个 过 程 中 能 够 有 所 收获 。 











致谢 


本 书 最 初 的 想法 是 在 只 使 用 标准 库 的 情况 下 教授 基本 的 Go Web 编 
程 知 识 。 说 实在 的 ， 刚 开始 的 时 候 我 并 不 确定 这 个 想法 是 人 否 能 够 行 得 
通 ， 但 那些 花费 目 己 血汗 钱 来 购买 本 书 抢先 预 哆 版 的 读者 给 了 我 或 励 和 
动力 来 实现 这 个 想法 ， 因 此 在 这 里 我 要 问 我 的 读者 们 致 以 减 妇 的 感谢 ! 














写 书 是 一 项 团队 协作 活动 ， 尽 管 本 书 的 封面 上 只 记载 了 我 一 个 人 的 
字 ， 但 实际 上 大 量 幕后 人 员 也 为 这 本 书 付出 了 自己 的 心血 ， 他 们 分 别 














e Marina Michaels， 来 目地 球 另 一 侧 的 一 位 勤务 且 高 效 的 编辑 ， 她 总 
是 不 知 疲倦 地 配合 我 的 工作 ， 并 且 为 了 我 们 之 间 巨 大 的 时 差 而 不 断 
地 调整 自己 的 日 程 表 ; 





e Manning 出 版 社 的 相关 工作 人 员 : 文字 编辑 Liz Welch 和 校对 
Elizabeth Martin， 他 们 的 火眼金睛 让 错误 无 处 可 藏 ， 负 责 营 销 和 推 
广 本 书 的 Candace Gillhoolley 和 Ana Romac， 以 及 将 我 的 原稿 变 为 本 
书 的 Kevin Sullivan 和 Janet Vail; 


。 Jimmy Frasch6 对 我 的 原稿 进行 了 一 次 完整 的 技术 校对 ， 而 我 的 审 稿 
人 Alex Jacinto. Alexander Schwartz. Benoit Benedetti, Brian 
Cooksey, Doug Sparling, Ferdinando Santacroce, Gualtiero Testa, 
Harry Shaun Lippy. James Tyo, Jeff Lim, Lee Brandt, Mike 
Bright, Quintin Smith, Rebecca Jones, Ryan Pulling, Sam Zaydel 和 


Wes Shaddix 则 在 撰写 原稿 的 4 个 阶段 中 为 我 提供 了 大 量 有 价值 的 反 


"rH. 
Tot: 


。 这 本 书 的 抢先 预览 版 一 经 释 出 ， 我 在 新 加 坡 Go 社 区 的 朋友 们 就 迫 
不 及 符 地 把 它 癌 全 世界 广 而 告 之 了 ， 特 别 值得 一 提 的 是 Kai 
Hendry， 他 为 本 书 制作 了 一 个 详细 的 评论 视频 。 





另外 ， 我 还 要 感谢 Go 的 创造 者 Robert Griesemer、Rob Pike 和 Ken 
Thompson， 以 及 net/http . html/template 等 web 标准 库 的 开发 者 ， 
特别 是 Brad Fitzpatrick， 没 有 他 们 的 辛勤 付出 ， 这 本 书 束 不 可 能 出 现 。 


最 后 ， 也 是 最 必 不 可 少 的 ， 我 要 感谢 我 的 家 人 ， 包 括 我 杀 爱 的 妻子 
Wooi Ying， 以 及 在 身高 方面 后 来 居 上 的 我 的 儿子 Kai Wen。 我 希望 自己 
能 够 通过 创作 这 本 书 给 他 带 来 启发 ， 我 也 希望 他 会 自豪 地 阅读 这 本 书 ， 
并 从 中 有 所 收获 。 


ATA 


本 书 将 完整 地 介绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概念 ， 
并 且 在 这 个 过 程 中 只 使 用 Go 语言 自 带 的 标准 库 。 尽 管 本 书 的 部 分 章节 
会 对 其 他 库 以 及 其 他 主题 进行 讨论 ， 比 如 如 何 测试 Web 应 用 以 及 如 何 部 
署 Web 应 用 ， 但 本 书 的 主要 目的 还 是 教 读者 如 何在 只 使 用 Go 标准 库 的 情 
况 下 进行 Web 开 发 。 








本 书 要 求 读者 具备 基本 的 Go 编程 技能 并 掌握 Go 语言 的 语法 。 如 果 
读者 不 具备 这 些 知 识 ， 可 以 阅读 由 William Kennedy、Brian Ketelsen 和 
Erik St. Martin 创 作 的 Go in Action 叫 一 书 ， 该 书 也 是 由 Manning 出 版 社 出 
版 的 。 由 Addison-Wesley 出 版 社 出 版 、Alan Donovan 和 Brian Kernighan 
创作 的 The Go Programming Language (站 也 是 一 本 值得 一 读 的 好 书 。 除 
了 以 上 提 到 的 两 本 书 之 外 ， 网 上 也 有 非常 多 免费 的 Go 教程 可 供 浏 览 ， 
比如 ，Go 官 方 网 站 的 《Go 入 门 教程 》 (A Tour of Go) 

Chttp://tour.golang.org/) 就 是 一 个 很 棒 的 例子 。 





内 容 编排 





本 书 由 10 间 和 一 个 附录 组 成 。 


第 1 章 会 介绍 使 用 Go 开发 Web 应 用 的 方法 ， 并 痔 述 这 种 做 法 的 优点 
所 在 。 除 此 之 外 ， 本 章 还 会 对 HTTP 协议 等 构成 Web 应 用 的 关键 概念 做 
深入 浅 出 的 介绍 。 





第 2 章 会 以 一 步 一 个 脚印 的 方式 ， 带 领 读者 去 构建 一 个 简单 的 网 上 
论坛 ， 以 此 来 向 读者 展示 如 何 使 用 Go 构建 一 个 典型 的 Web 应 用 。 


第 3 章 会 更 加 详细 地 展示 使 用 net/http 包 接收 HTTP 请 求 的 方法 。 读 者 
将 学 会 如 何 编 写 Go Web 服 务 器 监听 HTTP 请 求 ， 以 及 如 何 使 用 处 理 器 和 
处 理 器 函数 处 理 这 些 请 求 。 


第 4 章 会 继续 介绍 处 理 HTTP 请 求 的 相关 细节 ， 重 点 讲述 Go 是 如 何 
处 理 请 求 并 返回 啊 应 的 。 除 此 之 外 ， 读 者 还 将 学 会 如 何 从 HTML 表 单 中 
获取 数据 以 及 如 何 使 用 cookie。 


第 5 章 将 会 介绍 由 text/template 库 和 html/template 库 组 成 的 
Go 模板 引擎 。 读 者 将 会 看 到 Go 提供 的 各 种 模板 机 制 ， 并 学 会 如 何 使 用 
Go 的 布局 (layout) 。 





第 6 章 将 会 对 Go 的 存储 策略 进行 讨论 。 该 者 将 学 会 如 何 通 过 结构 将 
数据 存储 到 内 存 里 面 ， 如 何 通过 CSV 格 式 以 及 gob 二 进 制 格式 将 数据 存 
储 到 文件 系统 里 面 ， 以 及 如 何 通过 SQL 和 SQL 映射 句 去 访问 关系 数据 
库 。 


第 7 章 将 展示 使 用 Go 语言 构建 Web 服 务 的 方法 。 读 者 不 仅 会 学 到 如 
何 使 用 Go 语言 构建 一 个 简单 的 Web 服务 ， 还 会 学 到 如 何 使 用 Go 语言 创 
建 并 分 析 XML 数 据 和 JSON 数 据 。 





第 8 章 将 回 读 者 传授 在 不 同 层级 中 测试 Go Web 应 用 的 不 同方 法 ， 其 
中 包括 单元 测试 、 基 准 测 试 以 及 HTTP 测 试 ， 除 此 之 外 ， 这 一 章 还 会 简 
单 介 绍 几 个 第 三 方 测 试 库 。 


第 9 章 会 介绍 在 Web 应 用 中 使 用 Go 语言 的 并 发 特性 的 方法 。 读 者 将 
会 了 解 到 Go 语言 的 各 个 并 用 特性， 并 学 会 如 何 使 用 这 些 特 性 提高 一 个 
图 像 生 成 Web 应 用 的 性 能 。 





第 10 章 是 本 书 的 最 后 一 章 ， 它 将 展示 Go Web 应 用 的 部 署 方法 。 读 
者 将 会 学 到 如 何 把 应 用 部 蜀 到 独立 的 服务 嚣 上， 如何 把 应 用 部 获 到 
Heroku、Google App Engine 之 类 的 云 平 台 上 ， 以 及 如 何 把 应 用 部 署 到 
Docker% 4& H [fi] . 





最 后 ， 本 书 的 附录 会 展示 在 不 同 平 台 上 安装 和 设置 Go 环境 的 方 
As 


代码 的 约定 以 及 下 载 


本 书 通过 代码 清 日 以 及 正文 内 钥 的 方式 展示 了 大 量 源 代码 。 为 了 跟 
一 般 的 正文 区 别 开 来 ， 书 中 的 源 代 码 都 会 使 用 等 宽 字 体 。 为 了 凸显 东 些 
代码 在 不 同 章节 之 间 的 区 别 ， 又 或 者 为 了 强调 正文 中 讨论 的 茶 些 代码 ， 
本 书 有 时 候 也 会 以 加 粗 的 方式 显示 代码 。 





除 此 之 外 ， 本 书 的 电子 书 还 会 使 用 彩色 字体 来 凸显 代码 命令 以 及 代 
码 输出 : 





curl -i 127.0.0.1:8080/write 

HTTP/1.1 200 OK 

Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 

Content-Type: text/html; charset-utf-8 


«html» 
«head»«title»Go Web Programming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 


</html> 


本 书展 示 的 所 有 代码 都 可 以 在 www.manning.com/books/go-web- 
programming 和 github.com/ sausheong/gwp 找 到 9! 。 


作者 简介 





郑 兆 雄 〈Sau Sheong Chang) ， 现 任 新 加 坡 能 源 有 限 公 司 数字 技术 
总 裁 ， 在 此 之 前 他 曾经 担任 过 PayPal 的 消费 者 工程 经 理 。Sau 是 Ruby 社 
区 和 Go 社区 一 位 活跃 的 贡献 者 ， 除 了 创作 书籍 之 外 ， 他 还 为 开源 项 目 
提交 代码 ， 并 在 各 种 技术 研讨 会 和 技术 会 议 上 发 言 。 
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作者 在 线 论 坛 


购买 本 书 英 文 版 的 读者 可 以 免费 地 访问 由 Manning 出 版 社 开 设 的 私 
有 Web 论 坛 ， 可 以 在 论坛 里 面 撰写 书评 、 提 出 技术 问题 并 接受 来 自作 者 
和 其 他 读者 的 帮助 。 为 了 访问 并 订阅 论坛 ， 需 要 先 使 用 浏览 器 访问 
www.manning.com/books/go-web-programming， 这 个 页 面 会 告诉 读者 注 
册 账 号 和 访问 论坛 的 方法 ， 除 此 之 外 ， 该 页 面 还 列举 了 论坛 提供 的 各 种 
帮助 以 及 论坛 的 各 项 规章 制度 。 


Manning 出 版 社 承 诺 为 读者 提供 论坛 作为 场所 ， 以 便 读 者 之 间 以 及 
读者 和 作者 之 间 可 以 进行 有 意义 的 对 话 ， 但 Manning 并 不 保证 作者 的 参 





与 程度 一 一 作者 对 论坛 的 任何 页 献 部 是 自愿 并 且 无 偿 的 ， 因 此 读者 应 该 
尽 可 能 地 提出 一 些 具有 挑战 性 的 问题 以 便 引 起 作者 的 兴趣 。 


只 要 本 书 仍 在 正常 销售 ， 本 书 的 作者 在 线 论坛 以 及 论坛 上 已 有 的 帖 
子 就 会 一 直 可 供 访 间 ， 
[1] Go in Action 的 中 文 版 已 由 人 民 邮 电 出 版 社 出 版 ， 中 文 版 书 名 为 《Go 
语言 实战 》。 一 ” 译 者 注 


[2] The Go Programming Language 的 中 文 版 已 由 机 械 工 业 出 版 社 出 版 ， 
中 文 版 书 名 为 《Go 程序 设计 语言 》。 一 一 译 者 注 


[3] 本 书展 示 的 所 有 代码 也 可 以 在 异步 社区 (www.epubit.com.cn) 中 本 
书页 面 免费 下 载 。 一 一 编者 注 


天 于 封面 捕 图 


本 书 的 封面 插图 系 Paolo Mercuri (1804—1884) 所 作 ， 标 题 为 “穿着 
中 世纪 服装 的 男人 ”， 该 插图 来 源 于 Camille Bonnard 搜 集 并 编辑 的 
Costumes Historiques ARRE) 多 卷 本 ， 该 书 于 19 世 纪 50 或 60 年 代 在 巴 
黎 出 版 ， 它 搜集 了 大 量 12 世 纪 、13 世 纪 、14 世 纪 和 15 世 纪 的 历史 服装 。 
随 着 异国 风情 和 历史 文明 在 19 世 纪 风 靡 ， 人 们 开始 着 迷 于 这 类 服 疙 收藏 
本 ， 并 类 此 去 探索 自己 所 在 的 世界 以 及 已 经 远 去 的 旧 世 界 。 





在 这 一 历史 国 册 中 ，Mercuri 丰 富 多 彩 的 画作 让 我 们 生动 地 回想 起 
了 数 百 年 前 ， 世 界 各 地 不 同城 市 和 地 区 之 间 的 文化 差异 。 无 论 是 在 街道 
还 是 乡间 ， 仅 仅 通 过 人 们 的 着 闭 残 可 以 八 九 不 离 十 地 辨识 他 们 的 社会 地 
位 、 从 事 的 行业 和 职业 。 在 经 历 了 数 个 世纪 的 变迁 以 后 ， 人 们 的 着 装 方 
式 已 经 发 生 了 很 大 的 变化 ， 当 初 直 富 多 彩 的 地 区 多 样 性 也 已 逐渐 消失 。 
时 至 今日 ， 仪 仅 通 过 着 装 已 经 很 难 区 分 不 同 大 洲 的 居民 了 ， 更 别 说 想 要 
知道 他 们 所 在 的 国家 和 城市 、 知 舌 他 们 的 社会 地 位 和 职业 了 。 乐 观 地 
讲 ， 也 许 我 们 已 经 放弃 了 妃 求 文化 上 的 多 样 性 ， 转 为 拥抱 更 丰富 多 彩 也 
更 快 节奏 的 技术 生活 了 。 














在 计算 机 书籍 正在 变 得 越 来 越 相 似 、 越 来 越 同 质 化 的 今天 ， 
Manning 出 版 社 希 望 通过 Mercuri 的 作品 ， 将 数 个 世纪 以 前 丰富 多 彩 的 地 
区 生活 融入 图 书 封 面 ， 以 此 来 赞美 计算 机 行业 不 断 创 新 和 敢 为 人 先 的 精 
神 。 








第 一 部 分 Go 与 Web 应 用 


Web 应 用 是 当今 使 用 最 为 广泛 的 一 类 软件 应 用 ， 连 接 人 至 互联 网 的 人 
们 基本 上 每 天 都 在 使 用 Web 应 用 。 因 为 很 多 看 上 去 像 是 原生 应 用 的 移动 
应 用 都 在 内 部 包含 了 使 用 Web 技 术 构 建 的 组 件 ， 所 以 使 用 移动 设备 的 人 
们 实际 上 也 是 在 使 用 Web 应 用 。 











因为 编写 Web 应 用 必须 对 HTTP 有 所 了 解 ， 所 以 接 下 来 的 两 章 将 对 
HTTP 进 行 介绍 。 除 此 之 外 ， 我 们 还 会 了 解 到 使 用 Go 语言 编写 Web 应 用 
的 优点 ， 并 且 实际 使 用 Go 语言 来 构建 一 个 简单 的 网 上 论坛 ， 然 后 鸟 本 
Web 应 用 的 各 个 组 成 部 分 。 


第 1 音 ”Go 与 Web 应 用 


本 章 主要 内 容 


e Web 应 用 的 定义 

。 使 用 Go 语言 编写 Web 应 用 的 优点 

e Web 应 用 编程 的 基本 知识 

。 使 用 Go 语言 编写 一 个 极为 简单 的 web 应 用 


Web 应 用 在 我 们 的 生活 中 无 处 不 在 。 看 看 我 们 日 党 使 用 的 各 个 应 用 
程序 ， 它 们 要 么 是 Web 应 用 ， 要 么 是 移动 App 这 类 Web 应 用 的 变种 。 无 
论 哪 一 种 编程 语言 ， 只 要 它 能 够 开发 出 与 人 类 交互 的 软件 ， 它 就 必然 会 
文 持 Web 应 用 开发 。 对 一 门 加 新 的 编程 语言 来 说 ， 它 的 开发 者 首先 要 做 
的 一 件 事 ， 就 是 构建 与 互联 网 Gnternet) 和 和 万维网 (World Wide Web) 
交互 的 库 Clibrary) 和 框架 ， 而 那些 更 为 成 熟 的 编程 语言 还 会 有 各 种 五 
花 八 门 的 web 开 发 工具 。 








Go 是 一 门 刚 开始 轩 露 头角 的 语言 ， 它 是 为 了 让 人 们 能 够 简单 且 高 
效 地 编写 后 端 系统 (backend system) 而 创建 的 。 这 门 语言 拥有 众多 先 
进 的 特性 ， 并 且 密 切 关 注 程 序 员 的 生产 力 以 及 各 种 与 速度 相关 的 事项 。 
和 其 他 语言 一 样 ，Go 语 言 也 提供 了 对 Web 编 程 的 文 持 。 目 从 问世 以 来 ， 
Go 语言 在 编写 Web 应 用 以 及 “x 即 服务 系统 ”(*-as-a-service system? 方面 
就 受到 了 热烈 奶 捧 。 








本 章 接 下 来 将 列举 一 些 使 用 Go 编写 Web 应 用 的 优点 ， 并 介绍 一 些 关 





于 Web 应 用 的 基本 知识 。 


1.1 使 用 Go 语言 构建 Web 心 用 


“为 什么 要 使 用 Go 语言 编写 Web 应 用 呢 ? ?作为 本 书 的 读者 ， 我 想 你 
肯定 很 想 知 道 这 个 问题 的 答案 。 本 书 是 一 本 教 人 们 如 何 使 用 Go 语言 进 
行 Web 编 程 的 图 书 ， 而 作为 本 书 的 作者 ， 我 的 任务 就 是 同 你 解释 为 什么 
人 们 会 使 用 Go 语言 进行 Web 编 程 。 本 书 将 在 接 下 来 的 内 容 中 陆续 介绍 
Go 语言 在 Web 开 发 方面 的 优点 ， 我 衷心 地 希望 你 也 能 够 对 这 些 优点 有 感 
同 里 受 的 想法 。 


Go 是 一 门 相对 比较 年 轻 的 编程 语言 ， 它 拥有 繁 采 并 且 仍 在 不 断 成 
长 的 社区 ， 并 且 它 也 非常 适合 用 来 编写 那些 需要 快速 运行 的 服务 器 端 程 
序 。 因 为 Go 语言 提供 了 很 多 过 程式 编程 语言 的 特性 ， 所 以 拥有 过 程式 
编程 语言 使 用 经 验 的 程序 员 对 Go 应 该 都 不 会 感到 陌生 ， 但 与 此 同时 ， 
Go 语言 也 提供 了 函数 式 编 程 方面 的 特性 。 除 了 内 置 对 并 发 编程 的 文 持 
之 外 ，Go 语 言 还 拥有 现代 化 的 包 管理 系统 、 垃 圾 收集 特性 以 及 一 系列 
包罗 万 象 、 威 力 强大 的 标准 库 。 











里 然 Go 目 带 的 标准 库 已 经 非常 丰富 和 宏大 了 ， 但 Go 仍然 拥有 许多 
质量 上 乘 的 开源 库 ， 它 们 可 以 对 标准 库 不 足 的 地 方 进 行 补充 。 本 书 在 大 
部 分 情况 下 都 会 尽 可 能 地 使 用 标准 库 ， 但 是 偶尔 也 会 使 用 一 些 第 三 方 开 
源 库 ， 以 此 来 展示 开源 社区 提供 的 一 些 另 尽 蹊 径 并 且 富有 创意 的 方法 。 








使 用 Go 语言 进行 Web 开 发 正 变 得 日 益 流 行 ， 很 多 公司 都 已 经 开始 使 
用 Go 了 ， 其 中 包括 Dropbox、SendGrid 这 样 的 基础 设施 公司 ，Square 和 


Hailo 这 样 的 技术 驱动 的 公司 ， 甚 至 是 BBC、 纽 约 时 报 这 样 的 传统 公 
司 。 


在 开发 大 规模 Web 应 用 方面 ，Go 语 言 提供 了 一 种 不 同 于 现 有 语言 和 
平台 但 叉 切实 可 行 的 方案 。 大 规模 可 扩展 的 Web 应 用 通常 需要 具备 以 下 
特质 : 


° 可 扩展 ; 
。 模块 化 ; 
。 可 维护 ; 


高 性 能 。 


接 下 来 的 几 小 节 将 分 别 对 这 些 特 质 进行 讨论 。 
1.1.1 G0 与 可 扩展 Web 应 用 


大 规模 的 Web 应 用 应 该 是 可 扩展 的 〈scalable) ， 这 意味 着 应 用 的 
管理 者 应 该 能 够 简单 、 快 速 地 提升 应 用 的 性 能 以 便 处 理 更 多 请 求 。 如 果 
一 个 应 用 是 可 扩展 的 ， 那 么 它 就 是 线性 的 ， 这 意味 着 应 用 的 管理 者 可 以 
通过 添加 更 多 硬件 来 获得 更 强 的 请 求 处 理 能 








有 两 种 方式 可 以 对 性 能 进行 扩展 : 


一 种 是 垂直 扩展 (vertical scaling) ， 即 提升 单 台 设 备 的 CPU 数量 
或 者 性 能 ; 

男 一 种 则 是 水 平 扩 展 (horizontal scaling) ， 即 通过 增加 计算 机 的 
数量 来 提升 性 能 。 











因为 Go 语言 拥有 非常 优异 的 并 发 编程 文 持 ， 所 以 它 在 垂直 扩展 方 
面 拥有 不 俗 的 表现 : 一 个 Go Web 应 用 只 需要 使 用 一 个 操作 系统 线程 
COS thread) ， 就 可 以 通过 调度 来 高 效 地 运行 数 十 万 个 goroutine。 


跟 其 他 Web 应 用 一 样 ，Go 也 可 以 通过 在 多 个 Go Web 应 用 之 上 架设 
代理 来 进行 高 效 的 水 平 扩展 。 因 为 Go Web 应 用 都 会 被 编译 为 不 包含 任 
何 动态 依赖 关系 的 静态 二 进 制 文件 ， 所 以 我 们 可 以 把 这 些 文件 分 发 到 没 
有 安 闭 Go 语言 的 系统 里 ， 从 而 以 一 种 简单 且 一 致 的 方式 部 普 Go Web 
用 。 


11.2 ”Go 与 模块 化 Web 应 用 


大 规模 Web 应 用 应 该 由 可 蔡 换 的 组 件 构成 ， 这 种 做 法 能 够 使 开发 者 
更 容易 添加 、 移 除 或 者 修改 特性 ， 从 而 更 好 地 满足 程序 不 断 变 化 的 需 
求 。 除 此 之 外 ， 这 种 做 法 的 另 一 个 好 处 是 使 开发 者 可 以 通过 复 用 模块 化 
的 组 件 来 降低 软件 开发 所 需 的 费用 。 





尽管 Go 是 一 门 静 态 类 型 语言 ， 但 用 户 可 以 通过 它 的 接口 机 制 对 行 

为 进行 描述 ， 以 此 来 实现 动态 类 型 匹配 Cdynamictyping) 。Go 话 言 的 
函数 可 以 接受 接口 作为 参数 ， 这 童 味 着 用 户 只 要 实现 了 接口 所 需 的 方 

法 ， 就 可 以 在 继续 使 用 现 有 代码 的 同时 间 系 统 中 引入 新 的 代码 。 与 此 同 
时 ， 因 为 Go 语言 的 所 有 类 型 都 实现 了 空 接口 ， 所 以 用 户 只 需要 创建 出 

一 个 接受 空 接口 作为 参数 的 函数 ， 就 可 以 把 任何 类 型 的 值 用 作 该 函数 的 
实际 参数 。 此 外 ，Go 语 言 还 实现 了 一 些 在 函数 式 编程 中 非常 常见 的 特 
性 ， 其 中 包括 函数 类 型 、 使 用 函数 作为 值 以 及 闭 包 ， 这 些 特性 允许 用 户 
使 用 已 有 的 函数 来 构建 新 的 函数 ， 从 而 帮助 用 户 构 建 出 更 为 模块 化 的 代 
e 

















Go 语言 也 经 常会 被 用 于 创建 微服 务 〈microservice) 。 在 微服 务 染 
构 中 ， 大 型 应 用 通常 由 多 个 规模 较 小 的 独立 服务 组 合 而 成 ， 这 些 独 立 服 
务 通常 可 以 相互 蔡 换 ， 并 根据 它们 各 自 的 功能 进行 组 织 。 比 如 ， 日 志 记 
录 服 务 会 被 归 类 为 系统 级 服务 ， 而 开具 账单 、 风 险 分 析 这 样 的 服务 则 会 
被 归 类 为 应 用 级 服务 。 创 建 多 个 规模 较 小 的 Go 服务 并 将 它们 组 合 为 单 
个 Web 应 用 ， 这 种 做 法 使 得 我 们 可 以 在 有 需要 的 时 候 对 应 用 中 的 服务 进 
行 蔡 换 ， 而 整个 web 应 用 也 会 因此 变 得 更 加 模块 化 。 


1.1.3 ”G0 与 可 维护 的 Web 应 用 


和 其 他 庞大 而 复杂 的 应 用 一 样 ， 拥 有 一 个 易于 维护 的 代码 库 
(codebase) 对 大 规模 的 Web 应 用 来 说 也 是 非常 重要 的 。 这 是 因为 大 规 
模 的 应 用 通 芝 都 会 不 断 地 成 长 和 演化 ， 所 以 开发 者 需要 经 党 性 地 回顾 并 
修改 代码 ， 而 修改 难 懂 、 笨 拙 的 代码 需要 人 花费 大 量 的 时 间 ， 并 且 隐 含 
可 能 会 造成 菜 些 功能 无 法 正常 运作 的 风险 。 因 此 ， 确 保 源 代码 能 够 以 适 
当 的 方式 组 织 起 来 并 且 具 有 展 好 的 可 维护 性 对 开发 者 来 说 就 显得 全 天 重 


要 了 。 

















Go 语言 的 设计 辟 励 恨 好 的 软件 工程 实践 ， 它 拥有 简洁 且 极 具 可 读 
性 的 语法 以 及 灵活 且 清 晰 的 包 管 理 系统 。 除 此 之 外 ，Go 语 言 还 有 一 整 
套 优 秀 的 工具 ， 它 们 不 仅 可 以 增强 程序 员 的 开发 体验 ， 还 能 够 帮助 他 们 
写 出 更 具 可 读 性 的 代码 ， 比 如 以 标准 化 方式 对 Go 代码 进行 格式 化 的 源 
代码 格式 化 程序 gofmt 就 是 其 中 一 个 例子 。 


因为 Go 语言 希望 文档 可 以 和 代码 一 同 演进 ， 所 以 它 的 文档 工具 
godoc 会 对 Go 源 代 人 码 及 其 注释 进行 语法 分 析 ， 然 后 以 HTML、 纯 文本 或 
者 其 他 多 种 格式 创建 出 相应 的 文档 。godoc 的 使 用 方法 非常 简单 ， 开 发 





者 只 需要 把 文档 写 到 源 代码 里 面 ，godoc 就 会 把 这 些 文档 以 及 与 之 相关 
联 的 代码 提取 出 来 ， 生 成 相应 的 文档 文件 。 





除 此 之 外 ，Go 还 内 置 了 对 测试 的 支持 : gotest 工 具 会 自动 寻找 与 源 
代码 处 于 同一 个 包 Cpackage) 之 内 的 测试 代码 ， 并 运行 其 中 的 功能 测 
试 和 性 能 测试 。Go 语 言 也 提供 了 Web 应 用 测试 工具 ， 这 些 工 具 可 以 模拟 
出 一 个 Web 服 务 器 ， 并 对 该 服务 器 生成 的 啊 应 〈response) 进行 记录 。 


1.1.4 ”G0 与 高 性 能 Web 应 用 





高 性 能 不 仅 意 味 着 能 够 在 短 时 间 内 处 理 大 量 请 求 ， 还 意味 着 服务 器 
能 够 快速 地 对 客户 端 进 行 啊 应 ， 并 让 终端 用 户 (end user) 能 够 快速 地 
执行 操作 。 


Go 语言 的 一 个 设计 目标 就 是 提供 接近 于 C 语 言 的 性 能 ， 尽 管 这 个 目 
标 目 前 尚未 达成 ， 但 Go 语言 现在 的 性 能 已 经 非常 具有 竞争 力 : Go 程序 
会 被 编译 为 本 地 人 码 (native code) ， 这 一 般 意 味 着 Go 程序 可 以 运行 得 比 
解释 型 语言 的 程序 要 快 ， 并 且 就 像 前 面 说 过 的 那样 ，Go 语 言 的 goroutine 
对 并 及 编程 提供 了 非常 好 的 支持 ， 这 使 得 Go 应 用 可 以 同时 处 理 多 个 请 

















希望 以 上 介绍 能 够 引起 你 对 使 用 Go 语言 及 其 平台 进行 Web 开 发 的 兴 
趣 。 但 是 在 学 习 如 何 使 用 Go 进行 Web 开 发 之 前 ， 我 们 需要 先 来 了 解 一 下 
什么 是 Web 应 用 ， 以 及 它们 的 工作 原理 是 什么 ， 这 会 给 我 们 学 习 之 后 几 
革 的 内 容 带 来 非常 大 的 帮助 。 


1.2 Web 应 用 的 工作 原理 





如 果 你 在 一 个 技术 会 议 上 疝 在 场 的 程序 员 们 提出 “什么 是 Web 应 
用 ”这 一 问题 ， 那 么 通常 会 得 到 五 花 八 门 的 回答 ， 有 些 人 甚至 可 能 还 会 
因为 你 问 了 个 如 此 基础 的 问题 而 感到 惊讶 和 不 解 。 通 过 不 同 的 人 对 这 个 
问题 的 不 同 回答 ， 我 们 可 以 了 解 到 人 们 对 Web 应 用 并 没有 一 个 十 分 明确 
的 定义 。 比 如 说 ，Web 服 务 算 不 算 Web 应 用 ? 因为 Web 服 务 通常 会 被 其 
他 软件 调用 ， 而 Web 应 用 则 是 为 人 类 提供 服务 ， 所 以 很 多 人 都 认为 Web 
服务 与 Web 应 用 是 两 种 不 同 的 事物 。 但 如 果 一 个 程序 能 够 像 RSS feed 那 
样 ， 产 生出 来 的 数据 既 可 以 被 其 他 软件 使 用 ， 又 可 以 被 人 类 理解 ， 那 么 
这 个 程序 到 底 是 一 个 Web 服务 还 是 一 个 web 应 用 呢 ? 














同样 地 ， 如 果 一 个 应 用 只 会 返回 HTML 页面 ， 但 却 并 不 对 页 面 进行 
任何 处 理 ， 那 么 它 是 一 个 Web 应 用 吗 ? 运行 在 web 浏览 器 之 上 的 Adobe 
Flash 程 序 是 一 个 Web 应 用 吗 ? 对 于 一 个 纯 HTML5 编 写 的 应 用 ， 如 果 它 
运行 在 一 个 长 期 驻 留 于 电脑 的 浏览 器 中 ， 那 么 它 算是 一 个 Web 应 用 吗 ? 
如 果 一 个 应 用 在 向 服务 器 发 送 请 求 时 没有 使 用 HTTP 协 议 ， 那 么 它 算 是 
一 个 Web 应 用 吗 ? 大 多 数 程 序 员 都 能 够 从 高 层次 的 角度 去 理解 Web 应 用 
是 什么 ， 但 是 一 旦 我 们 深入 一 些 ， 和 尝试 去 探究 Web 应 用 的 实现 层次 ， 事 
情 就 会 变 得 含糊 不 清 起 来 。 

















从 纯粹 且 狭 隘 的 角度 来 看 ，Web 应 用 应 该 是 这 样 的 计算 机 程序 : 它 
会 对 客户 端 发 送 的 HITP 请 求 做 出 响应 ， 并 通过 HTTP 响 应 将 HTML 回 传 
至 客户 端 。 但 这 样 一 来 ，Web 应 用 不 就 跟 Web 服 务 器 一 样 了 吗 ? 的 确 如 
此 ， 如 果 按 照 上 面 给 出 的 定义 来 看 ，Web 服 务 器 和 Web 应 用 将 没有 区 别 
: 一 个 Web 服 务 器 就 是 一 个 Web 应 用 (如 图 1-1 所 示 )。 








图 1-1 Web 应 用 最 基本 的 请 求 与 啊 应 结构 





将 Web 服 务 器 看 作 是 Web 应 用 的 一 个 问题 在 于 ， 像 httpd 和 Apache 这 
样 的 Web 服 务 器 都 会 监视 特定 的 目录 ， 并 在 接收 到 请 求 时 返回 位 于 该 目 
录 中 的 文件 (比如 Apache 就 会 对 docroot 目 录 进 行 监视 ) 。 与 此 相反 ， 
Web 应 用 并 不 会 简单 地 返回 文件 : 它 会 对 请 求 进行 处 理 ， 并 执行 应 用 程 
序 中 预先 设 定好 的 操作 (如 图 1-2 所 示 〉。 


Web 应 用 接收 请 求 ， 执 行 
程序 指定 的 操作 ， 然 后 返回 文件 。 


Wk 
d P 服务 器 文件 
响应 


图 1-2 Web 应 用 的 工作 原理 























从 以 上 观点 来 看 ， 我 们 也 许可 以 把 Web 服 务 器 看 作 是 一 种 特殊 的 
Web 应 用 ， 这 种 应 用 只 会 返回 被 请 求 的 文件 。 普 过 来 讲 ， 很 多 用 户 都 会 
把 使 用 浏览 器 作为 客户 端的 应 用 看 作 是 web 应 用 。 这 其 中 包括 Adobe 
Flash 应 用 、 单 页 Web 应 用 ， 甚 至 是 那些 不 使 用 HTTP 协 议 进 行 通信 但 却 
驻 留 在 果 面 或 系统 上 的 应 用 。 


为 了 在 书 中 讨论 web 编 程 的 相关 技术 ， 我 们 必须 给 这 些 技术 一 个 明 
确 的 定义 。 首 先 ， 让 我 们 来 给 出 应 用 的 定义 。 








应 用 (application〉 是 一 个 与 用 户 进 行 互动 并 帮助 用 户 执 行 指 定 活 
动 的 软件 程序 。 比 如 记 账 系统 、 人 力 资 源 系 统 、 架 面 出 版 软件 每。 而 
Web 应 用 则 是 部 署 在 web 之 上 ， 并 通过 Web 来 使 用 的 应 用 。 





换 句 话说 ， 一 个 程序 只 需要 满足 以 下 两 个 条 件 ， 我 们 就 可 以 把 它 看 
作 是 一 个 Web 应 用 : 
这 个 程序 必须 回 发 送 命令 请 求 的 客户 端 返 回 HTML， 而 客户 端 则 会 
向 用 户 展示 演 染 后 的 HIML; 
这 个 程序 在 向 客户 端 传送 数据 时 必需 使 用 HTTP 协 议 。 








在 这 个 定义 的 基础 上 ， 如 果 一 个 程序 不 是 向 用 户 泻 染 并 展示 
HTML， 而 是 向 其 他 程序 返回 某 种 非 HIML 格 式 的 数据 ， 那 么 这 个 程序 
就 是 一 个 为 其 他 程序 提供 服务 的 web 服 务 。 本 书 将 在 第 7 章 对 Web 服 务 
进行 更 详细 的 说 明 。 








与 大 部 分 程序 员 对 Web 应 用 的 定义 相 比 ， 上 面 给 出 的 定义 可 能 显得 
稍微 狭隘 了 一 些 ， 但 因为 这 个 定义 消除 了 所 有 的 模糊 与 不 清晰 ， 并 使 
Web 应 用 变 得 更 加 易于 理解 ， 所 以 它 对 于 本 书 讨论 的 问题 是 非常 有 帮助 
的 。 随 着 读者 对 本 书 阅 读 的 不 断 深入 ， 这 一 定义 将 变 得 更 为 清晰 ， 但 是 
在 此 之 前 ， 让 我 们 先 来 回顾 一 ThHTTIP 协 议 的 发 展 历程 。 





13 _ HTTP 简介 


HTTP 是 万 维 网 的 应 用 层 通信 协议 ，wWeb 页 面 中 的 所 有 数据 都 是 通 
过 这 个 看 似 简 单 的 文本 协议 进行 传输 的 。HTTP 非 常 朴 票 ， 但 却 异 常 地 
强大 一 一 这 个 协议 自 20 世 纪 90 年 代 定 义 以 来 ， 至 今 只 进行 了 3 次 迭代 修 
改 ， 其 中 HTTP 1.1 是 目前 使 用 最 为 广泛 的 一 个 版 本 ， 而 最 新 的 一 个 版 本 
则 是 HTTP 2.0， 又 称 HTTP/2。 





HTTP 的 最 初版 本 HTTP 0.9 是 由 Tim Berners-Lee 为 了 让 万 维 网 能 够 
得 以 被 采纳 而 创建 的 : 它 允 许 客户 端 与 服务 器 进行 连接 ， 并 同 服务 器 发 
送 以 空 行 (CRLF) 结尾 的 ASCII 字 符 串 请 求 ， 而 服务 器 则 会 返回 不 市 任 
何 元 数据 的 HTML 作 为 响应 。 








HTTP 0.9 之 后 的 每 个 新 版 本 实现 都 包含 了 大 量 的 新 特性 ，1996 年 发 
布 的 HTTP 1.0 就 是 由 大 量 特性 合并 而 成 的 ， 之 后 的 HTTP 1.1 版 本 于 1999 
年 发 布 ， 而 HTTP 2.0 版 本 则 于 2015 年 发 布 。 因 为 目前 使 用 最 为 广泛 的 还 
是 HTTP 1.1 版 本 ， 所 以 本 书 主要 还 是 对 HTTP 1.1 进 行 讨论 ， 但 也 会 在 适 
当 的 地 方 介绍 一 些 HTTP 2.0 的 相关 信息 。 


首先 ， 让 我 们 通过 一 个 简单 的 定义 来 说 明 什 么 是 HITP。 





HTTP 是 一 种 无 状态 、 由 文本 构成 的 请 求 -响应 〈request-response) 协 
议 ， 这 种 协议 使 用 的 是 客户 端 -服务 器 (client-server) 计算 模型 。 











请 求 - 啊 应 是 两 全 计算 机 进行 通信 的 基本 方式 ， 其 中 一 台 计 算 机 会 
问号 一 全 计算机 发 送 请 求 ， 而 接收 到 请 求 的 计算 机 则 会 对 请 求 进行 啊 
应 。 在 客户 站 -服务 需 计 算 模型 中 ， 发 送 请 求 的 一 方 “客户 喘 TAY] 
返回 啊 应 的 一 方 ( 服 务 器 ) 发 起 会 话 ， 而 服务 器 则 负责 为 客户 问 提 供 








服务 。 在 HITP 协 议 中 ， 客 户 端 也 被 称 作 用 户 代理 Cuser-agenO ， 而 服 
务 器 则 通常 会 被 称 为 Web 服 务 器 。 在 大 多 数 情 况 下 ，HITITP 客 户 端 都 是 
一 个 Web 浏览 器 。 





HTTP 是 一 种 无 状态 协议 ， 它 唯一 知道 的 就 是 客户 端 会 向 服务 器 发 
送 请 求 ， 而 服务 器 则 会 向 客户 端 返 回响 应 ， 并 且 后 续 发 生 的 请 求 对 之 前 
发 生 过 的 请 求 一 无 所 知 。 相 对 的 ， 像 FTP、Telnet 这 类 面向 连接 的 协议 
则 会 在 客户 端 和 服务 器 之 间 创 建 一 个 持续 存在 的 通信 通道 〈 其 中 Telnet 
在 进行 通信 时 使 用 的 也 是 请 求 - 啊 应 方式 以 及 客户 端 -服务 器 计算 模 
H) , 顺带 提 一 下 ，HTTP 1.1 也 可 以 通过 持久 化 连接 来 提升 性 能 。 





跟 很 多 互联 网 协议 一 样 ，HTTP 也 是 以 纯 文本 方式 而 不 是 二 进 制 方 
式 发 送 和 接收 协议 数据 的 。 这 样 做 是 为 了 让 开发 者 可 以 在 无 需 使 用 专门 
的 协议 分 析 工 具 的 情况 下 ， 和 弄 清楚 通信 中 正在 发 生 的 事情 ， 从 而 更 容易 
进行 故障 排 碍 。 


因为 HTTP 最 初 在 设计 时 只 用 于 传送 HTML， 所 以 HTTP 0.9 只 提供 
了 GET 这 一 个 方法 (method) ， 但 新 版 本 对 HTTP 的 扩展 使 它 逐 渐变 成 
了 一 种 通用 的 协议 ， 用 户 也 得 以 将 其 应 用 于 Web 应 用 等 分 布 式 系统 中 ， 
本 章 接 下 来 就 会 对 Web 应 用 进行 介绍 。 








1.4 Web 应 用 的 诞生 





在 万 维 网 出 现 不 久之 后 ， 人 们 开始 意识 到 一 点 : 尽管 使 用 Web 服 务 
器 处 理 静 态 HITMEL 文 件 这 个 主意 非常 棒 ， 但 如 果 HTML 里面 能 够 包含 动 
态 生 成 的 内 容 ， 那 么 事情 将 会 变 得 更 加 有 趣 。 其 中 ， 通 用 网 关 接 口 














(Common Gateway Interface, CGI ) 就 是 在 早期 尝试 动态 生成 HTML 内 
容 的 技术 之 一 。 


1993 年 ， 美 国 国 家 超级 计算 应 用 中 心 (National Center for 
Supercomputing Applications， NCSA) 编写 了 一 个 在 Web 服 务 器 上 调用 
可 执行 命令 行程 序 的 规范 (specification) ， 他 们 把 这 个 规范 命名 为 
CGI， 并 将 它 包 含 在 了 NCSA 开 发 的 广 受 欢迎 的 HTTPd 服 务 器 里 面 。 不 
过 NCSA 制 定 的 这 个 规范 最 终 并 没有 成 为 正式 的 互联 网 标准 ， 只 有 CGI 
这 个 名 字 被 后 来 的 规范 沿用 了 下 来 。 


CGI 是 一 个 简单 的 接口 ， 它 允许 Web 服 务 器 与 一 个 独立 运行 于 Web 
服务 器 进程 之 外 的 进程 进行 对 接 。 通 过 CGI 与 服务 占 进 行 对接 的 程序 通 
第 被 称 为 CGI 程序 ， 这 种 程序 可 以 使 用 任何 编程 语言 编号 一 一 这 也 是 我 
们 把 这 种 接口 称 之 为 “通用 ?接口 的 原因 ， 不 过 早期 的 CGI 程序 大 多 数 都 
是 使 用 Perl 语 言 编写 的 。 疝 CGI 程序 传递 输入 参数 是 通过 设置 环境 变量 
来 完成 的 ，CGI 程 序 在 运行 之 后 将 同 标准 输出 (stand output) 3& [ul £i 
果 ， 而 服务 器 则 会 将 这 些 结 果 传 送 至 客户 端 。 








与 CGI 同期 出 现 的 还 有 服务 器 端 包 含 〈server-side includes, SSI ) 
技术 ， 这 种 技术 允许 开发 者 在 HTML 文 件 里 面包 含 一 些 指令 
(directive) : 当 客 户 端 请 求 一 个 HTML 文 件 的 时 候 ， 服 务 器 在 返回 这 
个 文件 之 前 ， 会 先 执 行文 件 中 包含 的 指令 ， 并 将 文件 中 出 现 指令 的 位 置 
蔡 换 成 这 些 指令 的 执行 结 末 。SSI 最 常见 的 用 法 是 在 HIML 文 件 中 包含 
其 他 被 频繁 使 用 的 文件 ， 又 或 者 将 整个 网 站 都 会 出 现 的 页 面 首部 
(header) 以 及 尾部 (footer) 的 代码 段 嵌 入 HIML 文 件 中 。 














作为 例子 ， 以 下 代码 演示 了 如 何 通 过 SSI 指 令 将 navbar.shtml X 


件 中 的 内 容 包 含 到 HTMEL 文 件 中 : 


«html» 
«head»«title»Example SSI«/title»«/head» 
«body» 
<!--#include file-"navbar.shtml" --» 


«/body» 
«/html» 








SSI 技 术 的 最 终 演 化 结果 就 是 在 HIML 里 面包 含 更 为 复杂 的 代码 ， 
并 使 用 更 为 强大 的 解释 器 (interpreter) 。 这 一 模式 衍生 出 了 PHP、 
ASP、JSP 和 ColdFusion 等 一 系列 非常 成 功 的 引擎 ， 开 发 者 通过 使 用 这 些 
引擎 能 够 开发 出 各 式 各 样 复杂 的 Web 应 用 。 除 此 之 外 ， 这 一 模式 也 是 
Mustache、ERB、Velocity 等 一 系列 Web 模 板 引 擎 的 基础 。 








如 前 所 述 ，Web 应 用 是 为 了 通过 HTTP 向 用 户 发 送 定 制 的 动态 内 容 
而 诞生 的 ， 为 了 和 弄 明 白 Web 应 用 的 运作 原理 ， 我 们 必须 知道 HTTP 的 工 
作 过 程 ， 并 理解 HTTP 请 求 和 啊 应 的 运作 机 制 。 





15 HTTP 请求 





HTTP 是 一 种 请 求 -响应 协议 ， 协 议 涉 及 的 所 有 事情 都 以 一 个 请 求 开 
始 。 aub M dU Ei i (message) 一 样 ， 都 由 一 系列 文 
本 行 组 成 ， 这 些 文本 行 会 按照 以 下 顺序 进行 排列 : 





(1) 请 求 行 (request-line) ; 








(2) 零 个 或 任意 多 个 请 求 首部 Cheader ; 


Js 
(4) 可 选 的 报 文 主体 (body) 。 


一 个 典型 的 HTTP 请 求 看 上 去 是 这 个 样子 的 : 





GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 


User-Agent: Mozilla/5.0 
(empty line) 





这 个 请 求 中 的 第 一 个 文本 行 就 是 请 求 行 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 


请 求 行 中 的 第 一 个 单词 为 请 求 方法 (request method) ， 之 后 跟着 
的 是 统一 资源 标识 符 (Uniform Resource Identifier，URI ) 以 及 所 用 的 
HTTP 版 本 。 位 于 请 求 行 之 后 的 两 个 文本 行为 请 求 的 首部 。 注 意 ， 这 个 
报 文 的 最 后 一 on Ml dud DA er A zs 行 也 必须 存 
在 ， 至 于 报 文 是 售 包 含 主 体 则 需要 根据 请 求 使 用 的 方法 而 定 。 
1.5.1 请 求 方法 

请 求 方法 是 请 求 行 中 的 第 一 个 单词 ， 它 指明 了 客户 端 想 要 对 资源 执 
ATI ETE. HTTP 0.9 只 有 GET 一 个 方法 ，HTTP 1.0 添 加 了 POST 方法 和 
HEAD 方法 ， 而 HTTP 1.1 则 添加 了 PUT ~ DELETE ~ OPTIONS 、TRACE 和 
CONNECT 这 5 个 方法 ， 并 人 允许 开发 者 自行 添加 更 多 方法 一 一 很 多 人 立即 
就 把 这 个 功能 付 诸 实践 了 。 





关于 请 求 方法 的 一 个 有 趣 之 处 在 于 ，HTTP 1.1 要 求 必须 实现 的 只 


有 GET 方法 和 HEAD 方法 ， 而 其 他 方法 的 实现 则 是 可 选 的 ， 甚 至 连 POST 
方法 也 是 可 选 的 。 


各 个 HTTP 方 法 的 作用 说 明 如 下 。 


GET 命令 服务 器 返回 指定 的 资源 。 

HEAD 一 一 与 GET 方法 的 作用 类 似 ， 唯 一 的 不 同 在 于 这 个 方法 不 要 于 
服务 器 返回 报 文 的 主体 。 这 个 方法 通常 用 于 在 不 获取 报 文 主体 的 情 
况 下 ， 取 得 响应 的 首部 。 

POST 命令 服务 器 将 报 文 主体 中 的 数据 传递 给 URI 指 定 的 资源 ， 
至 于 服务 器 具体 会 对 这 些 数据 执行 什么 动作 则 取决 于 服务 器 本 喘 。 
PUT 命令 服务 器 将 报 文 主体 中 的 数据 设置 为 URI 指 定 的 资源 。 

如 果 URI 指 定 的 位 置 上 已经 有 数据 存在 ， 那 么 使 用 报 文 主体 中 的 数 
据 去 代 蔡 已 有 的 数据 。 如 果 资 源 尚未 存在 ， 那 么 在 URI 指 定 的 位 置 
上 新 创建 一 个 资源 。 





























DELETE 命令 服务 器 删除 URI 指 定 的 资源 。 
TRACE 命令 服务 器 返回 请 求 本 身 。 通 过 这 个 方法 ， 客 户 端 可 以 


知道 介 于 它 和 服务 器 之 间 的 其 他 服务 器 是 如 何 处 理 请 求 的 。 
OPTIONS 命令 服务 器 返回 ee an 

CONNECT 命令 服务 器 与 客户 端 建立 一 个 网 络 连接 。 方法 通 
常用 于 设置 SSL 隧 道 以 开启 HTTPS 功 能 











PATCH 命令 服务 器 使 用 报 文 主体 中 的 数据 对 URI 指 定 的 资源 进 
行 修改 。 


152 安全 的 请 求 方法 


如 果 一 个 HITP 方 法 只 要 求 服 务 器 提供 信息 而 不 会 对 服务 器 的 状态 
做 任何 修改 ， 那 么 这 个 方法 就 是 安全 的 (safe) 。GET 、HEAD 
. OPTIONS 和 TRACE 都 不 会 对 服务 器 的 状态 进行 修改 ， 所 以 它们 都 是 安 
全 的 方法 。 与 此 相反 ，POST 、PUT 和 DELETE 都 能 够 对 服务 器 的 状态 进 
行 修改 (比如 说 ， 在 处 理 POST 请 求 时 ， 服 务 器 存储 的 数据 就 可 能 会 发 
生变 化 )， 因 此 这 些 方法 都 不 是 安全 的 方法 。 





15.3 过 等 的 请 求 方 法 


如 果 一 个 HITP 方 法 在 使 用 相同 的 数据 进行 第 二 次 调用 的 时 候 ， 不 
会 对 服务 器 的 状态 造成 任何 改变 ， 那 么 这 个 方法 就 是 天 等 的 
Cidempotent) 。 根 据 安 全 的 方法 的 定义 ， 因 为 所 有 安全 的 方法 都 不 会 
修改 服务 器 状态 ， 所 以 它们 天 生 惑 是 时 等 的 。 








PUT 和 DELETE 虽然 不 安全 ， 但 却 是 窜 等 的 ， 这 是 因为 它们 在 进行 
第 二 次 调用 时 都 不 会 改变 服务 器 的 状态 : 因为 服务 器 在 执行 第 一 个 PUT 
请 求 之 后 ，URI 指 定 的 资源 已 经 被 更 新 或 者 创建 出 来 了 ， 所 以 针对 同一 
个 资源 的 第 二 次 PUT 请 求 只 会 执行 服务 器 已 经 执行 过 的 动作 ， 与 此 类 
似 ， 虽 然 服 务 器 对 于 同一 个 资源 的 第 二 次 DELETE 请 求 可 能 会 返回 一 个 
错误 ， 但 这 个 请 求 并 不 会 改变 服务 器 的 状态 。 





相反 ， 因 为 重复 的 POST 请 求 是 否 会 改变 服务 器 状态 是 由 服务 句 目 
号 决定 的 ， 所 以 POST 方法 既 不 安全 也 非 瞄 等 。 蚌 等 性 是 一 个 非常 重要 
的 概念 ， 本 书 第 7 章 在 介绍 Web 服 务 时 将 再 次 提 及 这 个 概念 。 


1.5.4 浏览 器 对 请 求 方 法 的 支持 


GET 方法 是 最 基本 的 HITP 方 法 ， 它 负责 从 服务 器 上 获取 内 容 ， 所 
有 浏览 器 都 支持 这 个 方法 。POST 方法 从 HTML 2.0 开始 可 以 通过 添加 
HTML 表 单 来 实现 : HTML 的 form 标签 有 一 个 名 为 method 的 属性 ， 用 
户 可 以 通过 将 这 个 属性 的 值 设置 为 get 或 者 post 来 指定 要 使 用 哪 种 方 
x. 


HTML 不 支持 除 GET 和 POST 之 外 的 其 他 HTTP 方 法 : 在 HTML5 规 范 
的 早期 草案 中 ，HTML 表 单 的 method 属性 曾经 添加 过 对 PUT 方法 和 
DELETE 方法 的 支持 ， 但 这 些 文 持 在 之 后 又 被 删除 了 。 


话 虽 如 此 ， 但 流行 的 浏览 器 通常 都 不 会 只 文 持 HTML 一 种 数据 格式 
一 一 用 户 可 以 使 用 XMLHttpRequest (XHR) 来 获得 对 PUT 方法 和 DELTE 
方法 的 支持 。XHR 是 一 系列 浏览 器 API， 这 些 API 通 常 由 JavaScript 包 更 

(实际 上 XHR 就 是 一 个 名 为 XMLHttpRequest 的 浏览 器 对 象 )。XHR 人 允 
许 程 序 员 向 服务 器 发 送 HTTP 请 求 ， 并 且 跟 “XMLHttpRequest”* 这 个 名 字 
所 暗示 的 不 一 样 ， 这 项 技术 并 不 仅仅 局 限于 XML 格式 一 一 包括 JSON 以 
及 纯 文 本 在 内 的 任何 格式 的 请 求 和 响应 都 可 以 通过 XHR 发 送 。 


1.5.5 “请求 首部 


HTTP 请 求 方法 定义 了 发 送 请 求 的 客户 器 想 要 执行 的 动作 ， 而 HTTP 
请 求 的 首部 则 记录 了 与 请 求 本 身 以 及 客户 端 有 关 的 信息 。 请 求 的 首部 由 
任意 多 个 用 冒号 分 隔 的 纯 文 本 键 值 对 组 成 ， 最 后 以 回 车 〈CR) 和 换行 
(LF) 结尾 。 




















作为 HTTP 1.1 RFC 的 一 部 分 ，RFC 7231 对 主要 的 一 些 HTTP 请 求 字 
Et (request field) 进行 了 标准 化 。 过 去 ， 非 标准 的 HTTP 请 求 通常 以 X- 


作为 前 级 ， 但 标准 并 没有 沿用 这 一 惯例 。 


大 多 数 HTTP 请 求 首部 都 是 可 选 的 ， 窒 主 (Host〉 首 部 字段 是 HTTP 
1.1 唯 一 强制 要 求 的 首部 。 根 据 请 求 使 用 的 方法 不 同 ， 如 采 请 





中 包含 有 可 选 的 主体 ， 那 么 请 求 的 首部 还 需要 带 有 内 容 长 度 


Length) 字段 或 者 传输 编码 〈Transfer-Encoding) 字段 。 表 1- 


些 常见 的 请 求 首 部 。 


表 1-1 常见 的 HTTP 请 求 首部 


























客户 端 在 HTTP 啊 应 中 能 够 接收 的 内 容 类 型 。 比 如 说 ， 客 户 关 


m HJ 以 通 





过 Accept: text/html 这 个 首部 ， 告 知 服务 器 自己 希望 在 响应 的 主体 中 








收 到 HTML 类 型 的 内 容 








客户 端 要 求 服 务 器 使 用 的 字符 集 编 码 。 比 如 说 ， 客 户 端 可 以 通过 
Accept-Charset: utf-8 这 个 首部 ， 告 知 服务 器 自己 希望 响应 的 主体 使 


























用 UTF-8 字 符 集 




















这 个 首部 用 于 向 服务 器 发 送 基本 的 身份 验证 证 书 





客户 端 应 该 在 这 个 首部 中 把 服务 器 之 前 设置 的 所 有 cookie 回 传 给 服务 
器 。 比 如 说 ， 如 果 服 务 器 之 前 在 浏览 器 上 设置 了 3 个 cookie， 
Cookie Cookie 首 部 字段 将 在 一 个 字符 串 里 面包 含 这 3 个 cookie， 并 使 
这 些 cookie 进 行 分 隔 。 以 下 是 一 个 Cookie 首 部 示例 : Cookie: 
my first cookie-hello; my second cookie-world 


Content- 


那么 
用 分 号 对 





求 的 报 文 
( Content- 


1 展示 了 一 


Length 请 求 主 体 的 字 节 长度 


当 请 求 包含 主体 的 时 候 ， 这 个 首部 用 于 记录 主体 内 容 的 类 型 。 在 发 

送 posT 或 puT 请 求 时 ， 内 容 的 类 型 默认 为 x-ww-form-urlen-coded ， 但 
Content-TyDe | 是 在 上 传 文件 时 ， 内 容 的 类 型 应 该 设置 为 ultipart/fomm-data (fe 

文件 这 一 操作 可 以 通过 将 input 标签 的 类 型 设置 为 file 来 实现 ) 






























































— 服务 器 的 名 字 以 及 端口 号 。 如 果 这 个 首部 没有 记录 服务 器 的 端口 号 ， 
了 驶 表 示 服 务 器 使 用 的 是 80 端 口 
发 起 请 求 的 页 面 所 在 的 地 址 
对 发 起 请 求 的 客户 端 ; 












































1.6 HTTP 响应 


HTTP 响 应 报 文 是 对 HTTP 请 求 报 文 的 回复 。 跟 HTTP 请 求 一 样 ， 
HTTP 啊 应 也 是 由 一 系列 文本 行 组 成 的 ， 其 中 包括 : 


e 一 个 状态 行 ; 
e 零 个 或 任意 数量 的 响应 首部 ; 
e 一 个 空 行 ; 


。 一 个 可 选 的 报 文 主体 。 


也 许 你 已 经 发 现 了 ，HTTP 啊 应 的 组 织 方式 跟 HTTP 请 求 的 组 织 方式 
是 完全 相同 的 。 以 下 是 一 个 典型 的 HTTP 啊 应 的 样子 (为 了 节省 篇 幅 ， 


我 们 省 略 了 报 文 主体 中 的 部 分 内 容 ) : 


266 OK 
Date: Sat, 22 Nov 2014 12:58:58 GMT 
Server: Apache/2 
Last-Modified: Thu, 28 Aug 2014 21:01:33 GMT 
Content-Length: 33115 
Content-Type: text/html; charset-iso-8859-1 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.or 
g/ 
TR/xhtm11/DTD/xhtmli-strict.dtd"» «html xmlns-'http://www.w3.0rg/1999 


/ 
xhtml'» «head»«title»Hypertext Transfer Protocol -- HTTP/1.1«/title»« 


/ 
head»«body»...«/body»«/html» 





HTTP 啊 应 的 第 一 行为 状态 行 ， 这 个 文本 行 包含 了 状态 码 Cstatus 
code) 和 相应 的 原因 短语 (reason phrase) ， Mc 吾 对 状态 码 进 行 了 
简单 的 描述 。 除 此 之 外 ， 这 个 例子 中 的 HITP 啊 应 还 包含 了 一 个 HIMEL 
格式 的 报 文 主体 。 


1.6.1 i] VG 


正如 之 前 所 说 ，HTTP 啊 应 中 的 状态 码 表 明了 啊 应 的 类 型 。HTTP 啊 
应 状态 码 共 有 5 种 类 型 ， 它 们 分 别 以 不 同 的 数字 作为 前 级 ， 如 表 1-2 所 
p 








表 1-2 HTTP 响 应 状态 码 



































1XX | 情报 状态 码 。 服 务 咒 通过 这 些 状 态 码 来 告知 客户 端 ， 自 己 己 经 接收 到 了 客户 端 
发 送 的 请 求 ， 并 且 已 经 对 请 求 进行 了 处 理 



































成 功 状 态 码 。 这 些 状 态 码 说 明 服 务 器 已 经 接收 到 了 客户 端 发 送 的 请 求 ， 并 且 已 
经 成 功 地 对 请 求 进 行 了 处 理 。 这 类 状态 码 的 标准 啊 应 为 "2ee ok" 























重 定向 状态 码 。 这 些 状态 码 表示 服务 器 已 经 接收 到 了 客户 端 发 送 的 请 求 ， 并 且 
已 经 成 功 处 理 了 请 求 ， 但 为 了 完成 请 求 指定 的 动作 ， 客 户 端 还 需要 再 做 一 些 其 
他 工作 。 这 类 状态 码 大 多 用 于 实现 URL 重 定向 






































客户 端 错误 状态 码 。 这 类 状态 码 说 明 客户 端 发 送 的 请 求 出 现 了 某 些 问题 。 在 这 
一 类 型 的 状态 码 中 ， 最 常见 的 就 是 "4e4 Not Found" 了 ， 这 个 状态 码 表示 服务 器 
无 法 从 请 求 指定 的 URL 中 找到 客户 端 想 要 的 资源 









































服务 器 错误 状态 码 。 当 服务 器 因为 某 些 原因 而 无 法 正确 地 处 理 请 求 时 ， 服 务 器 
就 会 使 用 这 类 状态 码 来 通知 客户 端 。 在 这 一 类 状态 码 中 ， 最 常见 的 就 是 “5ee 


Internal Server Error? 状态 码 了 

















1.6.2 Hj E up 


响应 首部 跟 请 求 首部 一 样 ， 都 是 由 冒号 分 隔 的 纯 文 本 键 值 对 组 成 ， 
并 且 同 样 以 回 车 (CR) 和 换行 (LF) 结尾 。 正 如 请 求 首部 能 够 告诉 服 
务 器 更 多 与 请 求 相关 或 者 与 客户 端 诉求 相关 的 信息 一 样 ， 啊 应 首部 也 能 
够 回 客户 端 传达 更 多 与 响应 相关 或 者 与 服务 器 (对 客户 端的 ) 诉求 相关 
的 信息 。 表 1-3 展 示 了 一 些 常见 的 响应 首部 。 











表 1-3 ”第 见 的 啊 应 首部 


首部 字段 作用 描述 





告知 客户 端 ， 服 务 器 支持 哪些 请 求 方法 





啊 应 主体 的 字 节 长 度 











C = 

如 果 啊 应 包含 可 选 的 主体 ， 那 么 这 个 首部 记录 的 就 是 主体 内 容 的 类 型 
ype 

以 格林 尼 治 标准 时 间 (GMT) 格式 记录 的 当前 时 间 


这 个 首部 仅 在 重 定向 时 使 用 ， 它 会 告知 客户 端 接 下 来 应 该 向 哪个 URL 
Location SR 
W> 


























"am EMRA cookie. ~A Sz ELTE] H] EA 815 EA Set-Cookie 
et-(LOOKI1E 


服务 器 通过 这 个 首部 来 告知 客户 端 ， 在 Authorization 请 求 首 部 中 应 该 提 
供 哪 种 类 型 的 身份 验证 信息 。 服 务 器 各 常会 把 这 个 首部 与 "4e1 
Unauthorized” 状 态 行 一 同 发 送 。 除 此 之 外 ， 这 个 首部 还 会 癌 服务 器 许 
Authenticate le MA E 
可 的 认证 授权 模式 〈schema) 提供 验证 信息 Cchallenge information) 


(比如 RFC 2617 摘 述 的 基本 和 摘要 访问 认证 模式 ) 




































































1.7 URI 


Tim Berners-Lee 在 创建 万 维 网 的 同时 ， 也 引入 了 使 用 位 置 字 符 串 表 
示 互 联网 资源 的 概念 。 他 在 1994 年 发 表 的 RFC 1630 中 对 统一 资源 标识 符 
(Uniform Resource Identifier, URD 进行 了 定义 。 在 这 篇 RFC 中 ， 他 描 
述 了 一 种 使 用 字符 串 表 示 资 源 名 字 的 方法 ， 以 及 一 种 使 用 字符 串 表 示 资 
源 所 在 位 置 的 方法 ， 其 中 前 一 种 方法 被 称 为 统一 资源 名 称 CUniform 
Resource Name, URN) ， 而 后 一 种 方法 则 被 称 为 统一 资源 定位 符 
(Uniform Resource Location; URL) 。URI 是 一 个 涵盖 性 术语 ， 它 包含 
了 URN 和 URL， 并 且 这 两 者 也 拥有 相似 的 语法 和 格式 。 因 为 本 书 只 会 对 
URL 进 行 讨 论 ， 所 以 本 书 中 提 及 的 URI 指 代 的 都 是 URL。 


URI 的 一 般 格 式 为 : 


分 >[ ?查询 参数 > ] [ # < 片段 > ] 








URI 中 的 方案 名 称 (scheme name) 记录 了 URI 下 在 使 用 的 方案 ， 它 
定义 了 URI 其 余部 分 的 结构 。 因 为 URI 是 一 种 非常 常用 的 资源 标识 方 
式 ， 所 以 它 拥有 大 量 的 方案 可 供 使 用 ， 不 过 本 书 在 大 多 数 情 况 下 只 会 使 
用 HTTP 方 案 。 


URI 的 分 层 部 分 (hierarchical part) 包含 了 资源 的 识别 信息 ， 这 些 
言 妃 会 以 分 层 的 方式 进行 组 织 。 如 果 分 层 部 分 以 双 斜 线 (// ) 开头 ， 
那么 说 明 它 包含 了 可 选 的 用 户 信息 ， 这 些 信息 将 以 @ 符号 结尾 ， 后 跟 分 
层 路 径 。 不 融 用 户 信息 的 分 层 部 分 就 是 一 个 单纯 的 路 径 ， 每 个 路 径 都 由 
一 连 串 的 分 段 CsegmenO 组 成 ， 各 个 分 段 之 间 使 用 单 斜 线 C/ ) 分 隔 。 





在 URI 的 各 个 部 分 当中 ， 只 有 "方案 名 称 ” 和 "分 层 部 分 ?是 必需 的 。 


以 问号 〈?) 为 前 绥 的 查询 参数 (query) 是 可 选 的 ， 这 些 参 数 用 于 包 
含 无 法 使 用 分 层 方式 表示 的 其 他 信息 。 多 个 查询 参数 会 被 组 织 成 一 连 串 
的 键 值 对 ， 各 个 键 值 对 之 间 使 用 & 符号 分 隔 。 


URI 的 男 一 个 可 选 部 分 为 片段 (fragment) ， 片 段 使 用 井 号 Gt) 
作为 前 级 ， 它 可 以 对 URI 定 义 的 资源 中 的 次 级 资源 (secondary 
resource) 进行 标识 。 当 URI 包 含 查 询 参 数 时 ，URI 的 片段 将 被 放 到 查询 
参数 之 后 。 因 为 URI 的 片段 是 由 客户 端 负责 处 理 的 ， 所 以 Web 浏 览 器 在 
将 URI 发 送 给 服务 器 之 前 ， 一 般 都 会 先 把 URI 中 的 片段 移 除 挥 。 如 果 程 
序 员 想 要 取得 URI 片 段 ， 那 么 可 以 通过 JavaScript 或 者 某 个 HTTP 客户 端 
库 ， 将 URI 和 片段 包含 在 一 个 GET 请 求 里 面 。 





让 我 们 来 看 一 个 使 用 HTTP 方 案 的 URI 示 例 : 
http://sausheong:password@www.example. com/ docs/file? 


name-sausheong&dlocation-singaporezsummary « 





这 个 URI 使 用 的 是 http 方案 ， 跟 在 方案 名 之 后 的 是 一 个 冒号 。 位 于 
Q 符号 之 前 的 分 段 sausheong:password 记录 的 是 用 户 名 和 密码 ， 而 跟 在 
用 户 信 息 之 后 的 www.example.comy/docs/file 就 是 分 层 部 分 的 其 余部 分 。 
位 于 分 层 部 分 最 高 层 的 是 服务 器 的 域名 www.example.com， 之 后 跟着 的 
两 个 层 分 别 为 doc 和 fie， 每 个 分 层 之 间 都 使 用 单 笠 线 分 隔 。 跟 在 分 层 部 
分 之 后 的 是 以 问号 (? ) 为 前 级 的 查询 参数 ， 这 个 部 分 包含 了 
name=sausheong 和 location=singapore 这 两 个 键 值 对 ， 键 值 对 之 间 使 用 一 
个 & 符号 连接 。 最 后 ， 这 个 URI 的 末尾 还 禹 有 一 个 以 井 写 〈# ) 为 前 组 
HJA Fto 











因为 每 个 URL 都 是 一 个 单独 的 字符 串 ， 所 以 URL 里 面 是 不 能 够 包含 
空格 的 。 此 外 ， 因 为 问号 (? ) MHS Gt) 等 符号 在 URL 中 具有 特殊 
的 含义 ， 所 以 这 些 符号 是 不 能 够 用 于 其 他 用 途 的 。 为 了 避 开 这 些 限 制 ， 
我 们 需要 使 用 URL 编 码 来 对 这 些 特殊 符号 进行 转换 (URL 编码 又 称 百 
分 号 编码 ) 。 


RFC 3986 定 义 了 URL 中 的 保留 字符 以 及 非 保留 字符 ， 所 有 保留 字符 
都 需要 进行 URL 编 码 : URL 编 码 会 把 保留 字符 转换 成 该 字符 在 ASCII 编 
码 中 对 应 的 字 节 值 (byte value) ， 接 着 把 这 个 字 节 值 表 示 为 一 个 两 位 长 
的 十 六 进 制 数 字 ， 最 后 再 在 这 个 十 六 进 制 数字 的 前 面 加 上 一 个 百 分 号 
d ) 。 








比如 说 ， 空 格 在 ASCII 编 码 中 的 字 节 值 为 32， 也 就 是 十 六 进 制 中 的 
20。 因 此 ， 经 过 URL 编 码 处 理 的 空格 束 成 了 %28 ，URL 中 的 所 有 空格 都 
会 被 瞪 换 成 这 个 值 。 比 如 在 接 下 来 展示 的 这 个 URL 里 面 ， 用 户 名 sau 和 
sheong 之 间 的 空格 束 被 蔡 换 成 了 %28 : http://www.example.com/docs/file? 





name=sau%20sheong&location=singapore 。 


1.8 HTTP/2 人 简介 


HTTP/2 是 HTTP 协 议 的 最 新 版 本 ， 这 一 版 本 对 性 能 非常 关注。 
HTTP/2 协 议 由 SPDY/2 协 议 改 进而 来 ， 后 者 最 初 是 Google 公 司 为 了 传输 
Web 内 容 而 开发 的 一 种 开放 的 网 络 协议 。 





与 使 用 纯 文 本 方式 表示 的 HTTP 1.x 不 同 ，HTTP/2 是 一 种 二 进 制 协 
W: 二 进 制 表示 不 仅 能 够 让 HTTP/2 的 语法 分 析 变 得 更 为 高 效 ， 还 能 够 





让 协议 变 得 更 为 紧凑 和 健壮 ; 但 与 此 同时 ， 对 那些 习惯 了 使 用 HTTP 1.x 
的 开发 者 来 说 ， 他 们 将 无 法 再 通过 telnet 等 应 用 程序 直接 发 送 HTTP/2 报 
文 来 进行 调试 。 


跟 HTTP 1.x 在 一 个 网 络 连接 里 面 每 次 只 能 发 送 单 个 请 求 的 做 法 不 
同 ，HTTP/2 是 完全 多 路 复 用 的 〈fully multiplexed) ， 这 意味 着 多 个 请 求 
和 啊 应 可 以 在 同一 时 间 内 使 用 同一 个 连接 。 除 此 之 外 ，HTTP/2 还 会 对 
首部 进行 压缩 以 减少 需要 传送 的 数据 量 ， 并 允许 服务 器 将 啊 应 推送 
(push) 至 客户 端 ， 这 些 措施 都 能 够 有 效 地 提升 性 能 。 











因为 HTTP 的 应 用 范围 是 如 此 的 广泛 ， 对 语法 的 任何 贸然 修改 都 有 
可 能 会 对 已 有 的 Web 造 成 破坏 ， 所 以 尽管 HITP/2 对 协议 的 通信 性 能 进行 
了 优化 ， 但 它 并 没有 对 HTTP 协 议 本 号 的 语法 进行 修改 : 在 HTTP/2 中 ， 
HTTP 方 法 和 状态 码 等 功能 的 语法 还 是 跟 HTTP 1.1 时 一 样 。 


在 Go 1.6 版 本 中 ， 用 户 在 使 用 HTTPS 时 将 自动 使 用 HTTP/2， 而 Go 
1.6 之 前 的 版 本 则 在 golang.org/x/net/http2 包 里 面 实 现 了 HTTP/2 协 
议 。 本 书 的 第 3 章 将 会 介绍 如 何 使 用 HTTP/2。 


1.99 Web 应 用 的 各 个 组 成 部 分 
通过 前 面 的 介绍 ， 我 们 知道 了 Web 应 用 就 是 一 个 执行 以 下 任务 的 程 


CD 通过 HTTP 协 议 ， 以 HITP 请 求 报 文 的 形式 获取 客户 端 输 入 ; 


(2) 对 HTTP 请 求 报 文 进行 处 理 ， 并 执行 必要 的 操作 ; 


(3) 生成 HIML， 并 以 HITTP 咯 应 报 文 的 形式 将 其 返回 给 客户 端 。 


为 了 完成 这 些 任务 ，Web 应 用 被 分 成 了 处 理 器 Chandler) 和 模板 引 


Zk (template engine) 这 两 个 部 分 。 
1.9.1 ”处理 右 


Web 应 用 中 的 处 理 器 除了 要 接收 和 处 理 客 户 端 发 来 的 请 求 ， 还 需要 
调用 模板 引擎 ， 然 后 由 模板 引擎 生成 HTML 并 把 数据 填充 至 将 要 回 传 给 
客户 端的 啊 应 报 文 当中 。 


用 MVC 模 式 来 讲 ， 处 理 器 既是 控制 有 Ccontrolle) ， 也 是 模型 
(model〉。 在 理想 的 MVC 模 式 实现 中 ， 控 制 器 应 该 是 “苗条 的 ”， 它 应 
该 只 包含 路 由 (Gouting) 代码 以 及 HTTP 报 文 的 解 包 和 打包 人 逻辑， 而 模 
型 则 应 该 是 “丰满 的 "， 它 应 该 包含 应 用 的 逻辑 以 及 数据 。 
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模型 -视图 -控制 器 CModel-View-Controller; MVC) 模式 是 编写 Web 应 用 时 常用 的 模式 ， 
这 个 模式 是 如 此 的 流行 ， 以 至 于 人 们 有 时 候 会 错误 地 把 这 一 模式 当成 了 Web 应 用 开发 本 身 。 


























实际 上 ，MVC 模 式 最 初 是 在 20 世 纪 70 年 代 末 的 施乐 帕 罗 奥 多 研究 中 心 (Xerox PARC) 被 
引入 到 Smalltalk 语 言 里 面 的 ， 这 一 模式 将 程序 分 成 了 模型 、 视 图 和 控制 器 3 个 部 分 ， 其 中 模型 
用 于 表示 底层 的 数据 ， 而 视图 则 以 可 视 化 的 方式 向 用 户 展示 模型 ， 至 于 控制 器 则 会 根据 用 户 
的 输入 对 模型 进行 修改 。 每 当 模 型 发 生变 化 时 ， 视 图 都 会 自动 进行 更 新 ， 从 而 展现 出 模型 的 
最 新 状态 。 












































尽管 MVC 模 式 起 源 于 泉 面 开发 ， 但 它 在 编写 Web 应 用 方面 也 流行 了 起 来 一 一 包括 Ruby on 
Rails、Codelgniter、Play 和 Spring MVC 在 内 的 很 多 Web 应 用 框架 都 把 MVC 用 作 它 们 的 基本 模 
式 。 在 这 些 框架 里 面 ， 模 型 一 般 都 会 通过 结构 (struct) 或 对 象 Cobject) 映射 (map) 到 数据 
库 ， 而 视图 则 会 被 泻 染 为 HIML， 至 于 控制 器 则 负责 对 请 求 进行 路 由 ， 并 管理 对 模型 的 访问 。 




























































































使 用 MVC 框 架 进 行 Web 应 用 开发 的 新 手 程 序 员 常 第 会 误 以 为 MVC 模 式 是 开发 Web 应 用 的 
唯一 方法 ， 但 Web 应 用 本 质 上 只 是 一 个 通过 HTTP 协 议 与 用 户 互 动 的 程序 ， 只 要 能 够 实现 这 种 







































































互动 ， 程 序 本 身 可 以 使 用 任何 一 种 模式 开发 ， 甚 至 不 使 用 模式 也 是 可 以 的 。 














为 了 防止 模型 变 得 过 于 及 和 肿 ， 并 且 出 于 代码 复 用 的 需要 ， 开 发 者 有 
时 候 会 使 用 服务 对 象 Cservice object) 或 者 函数 (function) 对 模型 进 
行 操 作 。 尽 管 服务 对 象 严格 来 说 并 不 是 MVC 模 式 的 一 部 分 ， 但 是 通过 
把 相同 的 逻辑 放置 到 服务 对 象 里 面 ， 并 将 同一 个 服务 对 象 应 用 到 不 同 的 
模型 之 上 ， 可 以 有 效 地 避免 在 多 个 模型 里 面 复制 相同 代码 的 窘境 。 


正如 之 前 所 说 ，Web 应 用 并 不 是 一 定 要 用 MVC 模 式 进 行 开发 一 一 通 
过 将 控制 器 和 模型 进行 合并 ， 然 后 由 处 理 器 直接 执行 所 有 操作 并 向 客户 
端 返回 响应 的 做 法 不 仅 是 可 行 的 ， 而 且 也 是 十 分 合理 的 。 








1.9.2 ”模板 引擎 


通过 HTTP 响 应 报 文 回 传 给 客户 端的 HTML 是 由 模板 (template) f 
换 而 成 的 ， 模 板 里 面 可 能 会 包含 HTML， 但 也 可 能 不 会 ， 而 模板 引擎 
(template engine) 则 通过 模板 和 数据 来 生成 最 终 的 HIML。 正 如 之 前 所 
说 ， 模 板 引 擎 是 经 由 早期 的 SSI 技 术 演变 而 来 的 。 








模板 可 以 分 为 静态 模板 和 动态 模板 两 种 ， 这 两 种 模板 都 有 各 目的 设 


WE. 


。 静态 模板 de ERRE GR DEREUHTML, Bie Co | EXERCERE S 
模板 中 的 占 位 符 丛 换 成 相应 的 数据 来 生成 最 终 的 HIML， 这 种 做 法 
和 SSI 技 术 的 概念 非常 相似 。 因 为 静态 模板 通 凋 不 包含 任何 馆 辑 代 
码 ， 叉 或 者 只 包含 少量 逻辑 代码 ， 所 以 这 种 模板 也 称 为 无 逻辑 模 





板 。CTemplate 和 Mustache 都 属于 静态 模板 引擎 。 

e 动态 模板 除了 包含 HTML 和 占 位 符 之 外 ， 还 包含 一 些 编程 语言 结 
H. WREE AREMA E. JavaServer Pages (JSP) 、 
Active Server Pages (ASP) 和 Embedded Ruby (ERB) 都 属于 动态 
模板 引擎。PHP 刚 诞生 的 时 候 看 上 去 也 像 是 一 种 动态 模板 ， 它 是 之 
后 才 逐 渐 演 变 成 一 门 编程 语言 的 。 





到 目前 为 止 ， 本章 已 经 介绍 了 很 多 Web 应 用 背后 的 基础 知识 以 及 原 
理 。 初 看 上 去 ， 这 些 内 容 可 能 会 显得 过 于 琐碎 了 ， 但 随 着 读者 对 本 书 内 
容 的 不 断 深入 ， 理 解 这 些 基础 知识 的 重要 性 就 会 慢 慢 地 显现 出 来 。 在 了 
解 了 Web 应 用 开发 所 需 的 基本 知识 之 后 ， 现 在 是 时 候 进 入 下 一 个 阶段 
一 一 开始 实际 地 进行 Go 编程 了 。 在 接 下 来 的 一 他， 我 们 将 开始 学 习 如 
何 使 用 Go 开发 Web 应 用 。 








1.10 Hello Go 


在 这 一 他， 我 们 将 开始 学 习 如 何 实际 地 使 用 Go 语言 构建 Web 应 用 。 
如 果 你 还 没有 安装 Go， 那 么 请 先 阅 读本 书 的 附录 ， 根 据 附录 中 的 指示 
安装 Go 并 设置 相关 的 环境 变量 。 本 节 在 构建 Web 应 用 时 将 会 用 到 Go 的 
net/http 包 ， 因 为 本 书 将 会 在 接 下 来 的 几 章 中 对 这 个 包 进 行 详细 的 介 
绍 ， 所 以 即使 目前 对 这 个 包 知之 甚 少 ， 也 不 必 过 于 担心 。 目 前 来 说 ， 你 
只 需要 在 电脑 上 键入 本 节 展 示 的 代码 ， 编 译 它 ， 然 后 观察 这 些 代 码 是 如 
何 运行 的 束 可 以 了 。 习 惯 了 使 用 大 小 写 无 关 编程 语言 的 读者 请 注意 ， 因 
为 Go 语言 是 区 分 大 小 写 的 ， 所 以 在 键入 本 书展 示 的 代码 时 请 务必 注意 
代码 的 大 小 写 。 


























本 书展 示 的 所 有 代码 都 可 以 在 这 个 GitHub 页 面 找到 : 
https://github.com/sausheong/gwp - 


请 在 你 的 工作 空间 的 src 目录 中 创建 一 个 first_webapp 子 目 录 ， 


并 在 这 个 子 目 录 里 面 创 建 一 个 server .go 文件 ， 然 后 将 代码 清单 1-1 中 
展示 的 源 代码 键入 到 文件 里 面 。 








代码 清单 1-1 使 用 Go 构建 的 Hello World Web 应 用 

















package main 


"net/http" 
) 


func handler(writer http.ResponseWriter, request *http.Request) { 


fmt.Fprintf(writer, "Hello World, %s!", request.URL.Path[1:]) 


} 


func main() { 
http.HandleFunc("/", handler) 
http.ListenAndServe(":8080", nil) 


} 





在 一 切 就 绪 之 后 ， 请 打开 你 的 终端 ， 执 行 以 下 命令 : 


$ go install first webapp 


你 可 以 在 任意 目录 中 执行 这 个 命令 。 在 正确 地 设置 了 GOPATH 环境 
变量 的 情况 下 ， 这 个 命令 将 在 你 的 $GOPATH/bin 目录 中 创建 一 个 名 
为 first_webapp 的 二 进 制 可 执行 文件 ， 接 着 就 可 以 在 终端 里 面 运行 这 
个 文件 了 。 如 果 你 按照 附录 的 指示 ， 将 $GOPATH/bin 目录 也 添加 到 了 





PATH 环境 变量 当中 ， 那 么 你 也 可 以 在 任意 目录 中 执行 first_webapp 
文件 。 被 执行 的 first_webapp 文件 将 在 系统 的 8080 端 口上 启动 你 的 
Web 应 用 。 一 切 就 这 么 简单 ! 


现在 ， 打 开 网 页 浏览 器 ， 访 问 http:/localhost:8080/。 如 果 一 切 正 
常 ， 那 么 你 将 会 看 到 图 1-3 所 示 的 内 容 。 


© | http://localhost:8080/ x Do 
(€) @ localhost:8080 e = 


Hello World, ! 








图 1-3 ”我 们 创建 的 首 个 Web 应 用 


让 我 们 来 仔细 地 分 析 一 下 这 个 Web 应 用 的 代码 。 第 一 行 代码 声明 了 
这 个 程序 所 属 的 包 ， 跟 在 package 关键 字 之 后 的 main 就 是 包 的 名 字 。 
Go 语言 要 求 可 执行 程序 必须 位 于 main 包 当 中 ，Web 应 用 也 不 例外 。 如 
果 你 曾经 使 用 过 Ruby、Python 或 者 Java 等 其 他 编程 语言 来 开发 Web 应 











用 ， 那 么 你 可 能 已 经 发 现 了 Go 和 这 些 语言 之 间 的 区 别 : 其 他 语言 通 

需要 将 Web 应 用 部 署 到 应 用 服务 器 上 面 ， 并 由 应 用 服务 器 为 Web 应 ue 
供 运 行 环境 ， 但 是 对 Go 来 说 ，Web 应 用 的 运行 环境 是 由 net/http 包 直 
接 提供 的 ， 这 个 包 和 应 用 的 源 代 码 会 一 起 被 编译 成 一 个 可 以 快速 部 普 的 
独立 Web 应 用 。 





位 于 package 语句 之 后 的 Import 语句 用 于 导入 所 需 的 包 : 


import ( 
"fmt" 
"net/http" 


) 





被 导入 的 包 分 别 为 fmt 包 和 http 包 ， 前 者 使 得 程序 可 以 使 
用 Fprintf 等 函数 对 MO 进行 格式 化 ， 而 后 者 则 使 得 程序 可 以 与 HITP 进 
行 交 互 。 顺 带 一 提 ，Go 的 import 语句 不 仅 可 以 导入 标准 库 里 面 的 包 ， 
还 可 以 从 第 三 方 库 里 面 导入 包 。 











出 现在 导入 语句 之 后 的 是 一 个 函数 定义 : 


func handler(writer http.ResponseWriter, request *http.Request) { 
fmt.Fprintf(writer, "Hello World, %s!", request.URL.Path[1:]) 


} 





这 3 行 代码 定义 了 一 个 名 为 handler 的 函数 。 处 理 器 Chandler ) 这 
个 名 字 通 常用 来 表示 在 指定 事件 被 触发 之 后 ， 负 责 对 事件 进行 处 理 的 回 
调 函 数 ， 这 也 正 是 我 们 如 此 命名 这 个 函数 的 原因 (不 过 从 技术 上 来 说 ， 
至 少 在 Go 语言 里 面 ， 这 个 函数 并 不 是 一 个 处 理 器 ， 而 是 一 个 处 理 器 函 
数 ， 处 理 器 和 处 理 器 函数 之 间 的 区 别 将 在 第 3 章 中 介绍 )。 








这 个 处 理 器 函数 接受 两 个 参数 作为 输入 ， 第 一 个 参数 
为 ResponseWriter 接口 ， Meno ciue s NI IU; 吉 构 的 指 
tl. handler 函数 会 从 Request 结构 中 提取 相关 的 信息 ， 然 后 创建 一 个 
HTTP 响 应 ， 最 后 再 通过 ResponseWNriter 接口 将 响应 返回 给 客户 端 。 
至 于 handler 函数 内 部 的 Fprintf 函数 在 被 调用 时 则 会 使 用 一 
个 ResponseWriter 接口 、 一 个 之 有 单个 格式 化 指示 符 As) 的 格式 
化 字符 串 以 及 从 Request 结构 里 面 提取 到 的 路 径 信 息 作 为 参数 。 因 为 我 
们 之 前 访问 的 地 址 为 http://localhost:8080/， 所 以 应 用 并 没有 打印 出 任何 
路 径 信 息 ， 但 如 果 我 们 访问 地 址 
http://localhost:8080/sausheong/was/here， 那 么 浏览 器 应 该 会 展示 出 图 1-4 
所 示 的 信息 。 





Go 语言 规定 ， 每 个 需要 被 编译 为 二 进 制 可 执行 文件 的 程序 都 必须 
包含 一 个 main 函数 ， 用 作 程 序 执行 时 的 起 点 : 


func main() { 
http.HandleFunc("/", handler) 


http.ListenAndServe(":8080", nil) 








这 个 main 函数 的 作用 非常 直观 ， 它 首先 把 之 前 定义 的 handler K 
Mi (root) URL (/ 2 被 访问 时 的 处 理 器 ， 然 后 启动 服务 器 并 

它 监 听 系 统 的 8080 端 口 〈 按 下 Ctrl+C 可 以 停止 这 个 服务 器 ) 。 至 此 ， 
Go 语言 编写 的 Hello World Web 应 用 就 算 顺 利 完成 了 。 





© / http:Wlocalhost...usheong/was/here x | 4- 


y v : m 一 一 
| (€) € localhost:8080/sausheong/was/here e = 








Hello World, sausheong/was/here! 


图 1-4 带 有 路 径 信息 的 Hello World 示 例 





本 章 以 介绍 Web 应 用 的 基础 知识 开始 ， 并 最 终 走马 观 花 地 编写 了 一 
个 简单 却 没什么 用 处 的 Go Web 应 用 作为 结束 。 在 接 下 来 的 一 章 中 ， 我 
们 将 会 看 到 更 多 代码 ， 并 学 习 如 何 使 用 Go 语言 以 及 它 的 标准 库 去 编写 
更 真实 的 Web 应 用 (不 过 这 些 应 用 距离 真正 生产 级 别 的 应 用 还 有 一 定 距 
离 ) 。 尽 管 第 2 章 出 现 的 大 量 代码 可 能 会 让 读者 有 一 种 圆 轿 厨 吏 的 感 
党 ， 但 我 们 将 会 从 中 学 习 到 一 个 典型 的 Go Web 应 用 是 如 何 组 织 的 。 
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。 使 用 Go 开发 的 Web 应 用 不 仅 具 有 可 扩展 、 模 块 化 和 可 维护 等 特性 ， 


而 且 使 用 Go 还 能 够 更 容易 地 开发 出 性 能 更 高 的 应 用 ， 因 此 Go 是 一 
门 非常 适合 进行 Web 开 发 的 编程 语言 。 

因为 Web 应 用 是 一 种 通过 HTTP 协 议 向 客户 端 返 回 HTML 的 程序 ， 
所 以 理解 HTTP 协 议 对 学 习 Web 应 用 开发 来 说 是 相当 重要 的 。 
HTTP 是 一 种 简单 、 无 状态 、 纯 文本 的 客户 端 -服务 器 协议 ， 它 用 于 
在 客户 端 和 服务 器 之 间 进 行 数据 交换 。 

HTTP 的 请 求 和 啊 应 都 以 相同 的 格式 进行 组 织 一 一 它们 首先 以 一 个 
请 求 行 或 者 响应 行 作 为 开始 ， 接 着 后 跟 一 个 或 多 个 首部 ， 最 后 还 有 
一 个 可 选 的 主体 。 

每 个 HTTP 请 求 都 有 一 个 请 求 行 ， 请 求 行 里 面包 含 一 个 HTTP 方 法 ， 
HTTP 方 法 标示 了 请 求 想 要 让 服务 器 执行 的 动作 。GET 方法 和 POST 
方法 是 最 常用 的 两 个 HTTP 方 法 。 

每 个 HITP 啊 应 都 有 一 个 啊 应 行 ， 啊 应 行 会 告知 客户 端 请 求 的 执行 
状态 。 

任何 Web 应 用 都 包含 处 理 器 和 模板 引擎 ， 这 两 个 主要 部 分 分 别 与 
HTTP 协 议 的 请 求 和 啊 应 相对 应 。 

处 理 器 负责 接收 HTTP 请 求 并 处 理 它们 。 

模板 引擎 负责 生成 HTML， 这 些 HTML 之 后 会 作为 HTTP 响 应 的 其 中 
一 部 分 被 回 传 至 客户 端 。 




















第 2 章 ChitChat iz 


本 章 主要 内 容 


。 使 用 Go 进行 Web 编 程 的 方法 
e 设计 一 个 典型 的 Go Web 应 用 
。 编写 一 个 完整 的 Go Web 应 用 
。 了 解 Go Web 应 用 的 各 个 组 成 部 分 


上 一 章 在 末尾 展示 了 一 个 非常 简单 的 Go Web 应 用 ， 但 是 因为 该 应 
用 只 是 一 个 Hello World 程 序 ， 所 以 它 实际 上 并 没有 什么 用 处 。 在 本 章 
中 ， 我 们 将 会 构建 一 个 简单 的 网 上 论坛 Web 应 用 ， 这 个 应 用 同样 非常 基 
础 ， 但 是 却 有 用 得 多 : 它 允 许 用 户 登 录 到 论坛 里 面 ， 然 后 在 论坛 上 发 布 
新 帖子 ， 又 或 者 回复 其 他 用 户 发 表 的 帖子 。 








虽然 本 章 介 绍 的 内 容 无 法 让 你 一 下 子 就 学 会 如 何 编写 一 个 非常 成 熟 
的 web 应 用 ， 但 这 些 内 容 将 教会 你 如 何 组 织 和 开发 一 个 Web 应 用 。 在 阅 
读 完 这 一 章 之 后 ， 你 将 进一步 地 了 解 到 使 用 Go 进行 Web 应 用 开发 的 相关 
An. 











如 采 你 觉得 本 章 介 绍 的 内 容 难 度 较 大 ， 又 或 者 你 觉得 本 章 展示 的 大 
量 代 码 看 起 来 让 人 和 沉 得 胆 战 心 怀 ， 那 也 不 必 过 于 担心 : 本 章 之 后 的 几 章 
将 对 本 章 介 绍 的 内 容 做 进一步 的 解释 ， 在 阅读 完 本 章 并 继续 阅读 后 续 章 
节 时 ， 你 将 会 对 本 章 介绍 的 内 容 有 更 加 深入 的 了 解 。 


2.1 ChitChat 简 介 





网 上 论坛 无 处 不 在 ， 它 们 是 互联 网 上 最 受 欢迎 的 应 用 之 一 ， 与 旧式 
的 电子 公告 栏 (BBS) 、 新 闻 组 〈Usenet) 和 电子 邮件 一 脉 相 承 。 雅 虎 
公司 和 Google 公 司 的 群 组 〈Groups) 都 非常 流行 ， 雅 虎 报 告 称 ， 他 们 总 
共 拥 有 1000 万 个 群 组 以 及 1.15 亿 个 群 组 成 员 ， 其 中 每 个 群 组 都 拥有 一 个 
自己 的 论坛 ， 而 全 球 最 具 人 气 的 网 上 论坛 之 一 一 一 Gaia 在 线 一 一 则 拥有 
2300 万 注册 用 户 以 及 接近 230 亿 张 帖子 ， 并 且 这 些 帖子 的 数量 还 在 以 每 
天 上 百 万 张 的 速度 持续 增长 。 尽 省 现在 出 现 了 诸如 Facebook 这 样 的 社交 
网 站 ， 但 论坛 仍然 是 人 们 在 网 上 进行 交流 时 最 为 常用 的 手段 之 一 。 作 为 
例子 ， 图 2-1 展 示 了 GoogleGroups 的 样子 。 








eoe «x 局 groups.googie.com/torum/atforum/golang-nuts v th 4 
Google JAMES 9 s 0 $ 
Groups 6 | Mark ali as read Filters ~ op e] H 


» golang-nuts Shared publicly 


60 of 20102 topics (99+ unread) * 3， About 


| El unserializing interface types with json (4) 4posts — 12:55 
El Extended logic in golang text/templates (2) 2 12:54 

* Dl Problem with custom types using Postgresq! (1) 1 11:45 
DJ How to organize a go project that also includes other languages? (1) 1 11:23 

El How to compile golang functions as a static library or a dynamic to explode to object-c? (2) 2 08:04 

E] FireBird connection (2) 2 08:01 

VJ Can we call a GO function/library in JAVA code? (4) 4 07:49 

El Go in Action vs Programming in Go (5) 5 05:57 

El GPL licensed go software (3) 3 04:34 
Dl Announcing gsoup: an HTML sanitizer (and some questions) (2) 2 04:00 

* EJ Which web framework is recommended to use with GO? (9) 9 02:05 
El beginner : best way to learn go (3) 3 00:45 

* BJ [RFC] Watching err with "watch" Expression Block [RFC] (14) 14 17 Jan 
* BJ Go runtime - GOMAXPROCSs and threads (4) 4 17 Jan 
El Poor performance reading stdin (40) 40 17 Jan 

t EJ time.Parse of two reference times aren't equal (7) 7 17 Jan 
UJ Capitalization of fields in private structs (16) 16 17 Jan 

EJ reaching for sync.WaitGroup feels wrong... (24) 24 17 Jan 

* Ed How do verify an xmi document containing a signature and X.509 data? (7) 7 17 Jan 
El Go 1.4.1 is released (10) 10 17 Jan 

* EJ How to read *.xis file using golang (3) 3 17 Jan 


图 2-1 一 个 网 上 论坛 示例 : GoogleGroups 里 面 的 Go 编程 语言 论坛 


从 本 质 上 来 说 ， 网 上 论坛 就 相当 于 一 个 任何 人 都 可 以 通过 发 帖 来 进 
行 对 话 的 公告 板 ， 公 告 板 上 面 可 以 包含 已 注册 用 户 以 及 未 注册 的 匿名 用 
户 。 论 坛 上 的 对 话 称 为 帖子 〈thread) ， 一 个 帖子 通常 包含 了 作者 想 要 
讨论 的 一 个 主题 ， 而 其 他 用 户 则 可 以 通过 回复 这 个 帖子 来 参与 对 话 。 比 
较 复杂 的 论坛 一 般 部 会 按 层级 进行 划分 ， 在 这 些 论坛 里 面 ， 可 能 会 有 多 
个 讨论 特定 类 型 主题 的 子 论坛 存在 。 大 多 数论 坛 都 会 由 一 个 或 多 个 拥有 
特殊 权限 的 用 户 进行 管理 ， 这 些 拥有 特殊 权限 的 用 户 被 称 为 版 主 


(moderator) 。 





在 本 章 中 ， 我 们 将 会 开发 一 个 名 为 ChitChat 的 简易 网 上 论坛 。 为 了 
让 这 个 例子 保持 简单 ， 我 们 只 会 为 ChitChat 实 现 网 上 论坛 的 关键 特性 : 
在 这 个 论坛 里 面 ， 用 户 可 以 注册 账号 ， 并 在 登录 之 后 发 表 新 帖子 又 或 者 
回复 己 有 的 帖子 ， 未 注册 用 户 可 以 查看 帖子 ， 但 是 无 法 发 表 帖 子 或 是 回 
复 帖 子 。 现 在， 让 我 们 首先 来 思考 一 下 如 何 设计 ChitChat 这 个 应 用 。 

















'ESETITITT 





跟 本 书 的 其 他 章节 不 一 样 ， 因 为 篇 幅 的 关系 ， 本 章 并 不 会 展示 ChitChat 论 坛 的 所 有 实现 代 
码 ， 但 你 可 以 在 GitHub 页 面 https://github.com/sausheong/gwp 找 到 这 些 代 码 。 如 果 你 打算 在 阅读 
本 章 的 同时 实际 了 解 一 下 这 个 应 用 ， 那 么 这 些 完整 的 代码 应 该 会 对 你 有 所 帮助 。 
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正如 第 1 章 所 说 ，Web 应 用 的 一 般 工 作 流程 是 客户 端 向 服务 器 发 送 
请 求 ， 然 后 服务 器 对 客户 端 进行 响应 《〈 如 图 2-2 所 示 ) ，ChitChat 应 用 的 
设计 也 遵循 这 一 流程 。 


1. 发 送 HTTP 请 求 2. 处 理 HTTP 请 求 





3. 返回 HTTP 了 响应 


图 2-2 ”Web 应 用 的 一 般 工 作 流 程 ， 客 户 问 向 服务 器 发 送 请 求 ， 然 后 等 待 接收 啊 应 








ChitChat 的 应 用 逻辑 会 被 编码 到 服务 器 里 面 。 服 务 吉 会 回 客 户 端 提 
供 HTML 页 面 ， 并 通过 页 面 的 超 链接 同 客 户 端 表明 请 求 的 格式 以 及 被 请 
求 的 数据 ， 而 客户 端 则 会 在 发 送 请 求 时 间 服 务 器 提供 相应 的 数据 ， 如 图 
2-3 所 示 。 





服务 器 会 通过 HTML 页 面 上 的 超 链 
接 ， 向 Web 应 用 表明 请 求 的 格式 。 


http://«servername»/«handlername»?«parameters» 


请 求 
客户 端 服务 器 
响应 


图 2-3 ” HTTP 请 求 的 URL 格 式 























请 求 的 格式 通常 是 由 应 用 自行 决定 的 ， 比 如 ，ChitChat 的 请 求 使 用 
的 是 以 下 格式 : http://< 服 务 器 名 >< 处 理 器 名 >?< 参 数 > 。 


服务 器 名 C server name) 是 ChitChat 服 务 器 的 名 字 ， 而 处 理 器 名 
(handler name) 则 是 被 调用 的 处 理 器 的 名 字 。 处 理 器 的 名 字 是 按 层 级 
进行 划分 的 : 位 于 名 字 最 开头 是 被 调用 模块 的 名 字 ， 而 之 后 跟着 的 则 是 
被 调用 子 模块 的 名 字 ， 以 此 类 推 ， 位 于 处 理 器 名 字 最 末尾 的 则 是 子 模块 
中 负责 处 理 请 求 的 处 理 器 。 比 如 ， 对 /thread/read 这 个 处 理 器 名 字 来 
说 ，thread 是 被 调用 的 模块 ， 而 read 则 是 这 个 模块 中 负责 读 取 帖子 内 
容 的 处 理 器 。 





该 应 用 的 参数 (parameter) 会 以 URL 碍 询 的 形式 传递 给 处 理 需 ， 
而 处 理 器 则 会 根据 这 些 参数 对 请 求 进行 处 理 。 比 如 说 ， 假 设 客户 端 要 回 
处 理 器 传递 帖子 的 唯一 JD， 那 么 它 可 以 将 URL 的 参数 部 分 设置 
成 id=123 ， 其 中 123 就 是 帖子 的 唯一 ID。 


如 果 chitchat 就 是 ChitChat 服 务 器 的 名 字 ， 那 么 根据 上 面 介 绍 的 
URL 格 式 规则 ， 客 户 端 发 送 给 ChitChat 服 务 器 的 URL 可 能 会 是 这 样 的 : 
http://chitchat/thread/read?id-123. 


当 请 求 到 达 服 务 嚣 时， 多 路 复 用 占 (multiplexer) 会 对 请 求 进行 检 
但， 并 将 请 求 重 定 同 至 正确 的 处 理 器 进行 处 理 。 处 理 器 在 接收 到 多 路 复 
用 器 转发 的 请 求 之 后 ， 会 从 请 求 中 取出 相应 的 信息 ， 并 根据 这 些 信息 对 
请 求 进行 处 理 。 在 请 求 处 理 完毕 之 后 ， 处 理 器 会 将 所 得 的 数据 传递 给 模 
板 引 擎 ， 而 模板 引擎 则 会 根据 这 些 数据 生成 将 要 返回 给 客户 端的 
HTML， 整 个 过 程 如 图 2-4 所 示 。 











多 路 复 用 器 会 对 URL 请 求 
进行 检查 ， 并 将 它 重 定向 
至 正确 的 处 理 器 。 






处 理 器 | 
处 理 器 会 向 模板 
mM 引擎 提供 数据 。 
处 理 器 


~ 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 

















图 2-4 ”服务 器 在 典型 Web 应 用 中 的 工作 流程 











2.3 ”数据 模型 


绝 大 多 数 应 用 都 需要 以 某 种 方式 与 数据 打交道 。 对 ChitChat 来 说 ， 
它 的 数据 将 被 存储 到 关系 式 数据 库 PostgreSQL 里面， 并 通过 SQL 与 之 交 
互 。 


ChitChat 的 数据 模型 非常 简单 ， 只 包含 4 种 数据 结构 ， 它 们 分 别 是 











e User 表示 论坛 的 用 户 信 息 
e Session 一 一 表示 论坛 用 户 当前 的 登录 会 W; 
e Thread— 一 表示 论坛 里 面 的 帖子 ， 每 一 个 帖子 都 记录 了 多 个 论坛 用 





P RB 
表示 用 户 在 帖子 里 面 添加 的 回复 。 


e Post 








以 上 这 4 种 数据 结构 都 会 被 映射 到 关系 数据 库 里 面 ， 图 2-5 展 示 了 这 
4 种 数据 结构 是 如 何 与 数据 库 交 互 的 。 





ChitChat 论 坛 允许 用 户 在 登录 之 后 发 布 新 帖子 或 者 回复 已 有 的 帖 
子 ， 示 登录 的 用 户 可 以 阅读 帖子 ， 但 是 不 能 发 布 新 帖子 或 者 回复 帖子 。 
为 了 对 应 用 进行 简化 ，ChitChat 论 坛 没 有 设置 版 主 这 一 职位 ， 因 此 用 户 
在 发 布 新 帖子 或 者 添加 新 回复 的 时 候 不 需要 经 过 审核 。 





图 2-5 ”Web 应 用 访问 数据 存储 系统 的 流程 


在 了 解 了 ChitChat 的 设计 方案 之 后 ， 现 在 可 以 开始 考虑 具体 的 实现 
代码 了 。 在 开始 学 习 ChitChat 的 实现 代码 之 前 ， 请 注意 ， 如 果 你 在 阅读 
本 章 展 示 的 代码 时 遇 到 困难 ， 又 或 者 你 是 刚 开 始 学 习 Go 语 言 ， 那 么 为 


了 更 好 地 理解 本 章 介 绍 的 内 容 ， 你 可 以 考虑 先 花 些 时 间 阅 读 一 本 Go 语 
言 的 编程 入 门 书 ， 比 如 ， 由 William Kennedy、Brian Ketelsen 和 Erik St. 
Martin 撰 号 的 《Go 语言 实战 》 束 是 一 个 很 不 错 的 选择 。 


除 此 之 外 ， 在 阅读 本 章 时 也 请 尽量 保持 耐性 ， 本 章 只 是 从 宏观 的 角 
度 展 示 Go Web 应 用 的 样子 ， 并 没有 对 Web 应 用 的 细节 作 过 多 的 解释 ， 
而 是 将 这 些 细 市 留 到 之 后 的 革 节 再 进一步 说 明 。 在 有 需要 的 情况 下 ， 本 
章 也 会 在 介绍 茶 种 技术 的 同时 ， 说 明 在 哪 一 章 可 以 找到 这 一 技术 的 更 多 
相关 信息 。 





24 请求 的 接收 与 处 理 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 正 如 之 前 所 说 ，Web 应 
用 的 工作 流程 如 下 。 


(1) 客户 端 将 请 求 发 送 到 服务 如 的 一 个 URL 上 。 


(2) 服务 器 的 多 路 复 用 器 将 接收 到 的 请 求 重 定 癌 到 正确 的 处 理 
恬 ， 然 后 由 该 处 理 絮 对 请 求 进行 处 理 。 


(3) 处 理 需 处 理 请 求 并 执行 必要 的 动作 。 


(4) 处 理 器 调用 模板 引擎 ， 生 成 相应 的 HTML 并 将 其 返回 给 客户 


让 我 们 先 从 最 基本 的 根 URL C/ ) 来 考虑 Web 应 用 是 如 何 处 理 请 求 
: 当 我 们 在 浏览 器 上 输入 地 址 http://1localhost 的 时 候 ， 浏 览 器 访 


cm 


问 的 束 是 应 用 的 根 URL。 在 接 下 来 的 几 个 小 节 里 面 ， 我 们 将 会 看 到 
ChitChat 是 如 何 处 理发 送 至 根 URL 的 请 求 的 ， 以 及 它 又 是 如 何 通 过 动态 
地 生成 HTML 来 对 请 求 进行 啊 应 的 。 


2.4.1 多 路 复 用 器 


因为 编译 后 的 二 进 制 Go 应 用 总 是 以 main 函数 作为 执行 的 起 点 ， 所 
以 我 们 在 对 Go 应 用 进行 介绍 的 时 候 也 总 是 从 包含 main 函数 的 主 源码 文 
件 (main source code file) 开始。ChitChat 应 用 的 主 源码 文件 为 main. go 
， 代 码 清单 2-1 展 示 了 它 的 一 个 简化 版 本 。 








代码 清单 2-1 main .go 文件 中 的 main 函数 ， 函 数 中 的 代码 经 过 了 简化 








package main 

import ( 
"net/http" 

) 


func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir("/public")) 


mux.Handle("/static/", http.StripPrefix("/static/", files)) 


mux.HandleFunc("/", index) 


server := &http.Server( 
Addr: "0.0.0.0:8080", 
Handler: mux, 

} 


server.ListenAndServe() 


} 





main.go 中 首先 创建 了 一 个 多 路 复 用 器 ， 然 后 通过 一 些 代 码 将 接收 
到 的 请 求 重 定向 到 处 理 器 。net/http 标准 库 提 供 了 一 个 默认 的 多 路 复 


用 器 ， 这 个 多 路 复 用 器 可 以 通过 调用 NewServeMux 函数 来 创建 : 


mux := http.NewServeMux() 


为 了 将 发 送 至 根 URE 的 请 求 重 定向 到 处 理 器 ， 程 序 使 用 了 
HandleFunc 函数 : 


mux.HandleFunc("/", index) 


HandleFunc 函数 接受 一 个 URL 和 一 个 处 理 器 的 名 字 作 为 参数 ， 并 
将 针对 给 定 URL 的 请 求 转发 至 指定 的 处 理 器 进行 处 理 ， 因 此 对 上 述 调用 
来 次， 当 有 针对 根 URL 的 请 求 到 达 时 ， 该 请 求 就 会 被 重 定向 到 名 
为 index 的 处 理 器 函数 。 此 外 ， 因 为 所 有 处 理 器 都 接受 一 
个 ResponseWriter 和 一 个 指向 Request 结构 的 指针 作为 参数 ， 并 且 所 
有 请 求 参数 都 可 以 通过 访问 Request 结构 得 到 ， 所 以 程序 并 不 需要 向 处 
理 器 显 式 地 传 入 任何 请 求 参 数 。 








需要 注意 的 是 ， 前 面 的 介绍 模糊 了 处 理 器 以 及 处 理 器 函数 之 间 的 区 
别 : 我 们 刚 开 始 谈论 的 是 处 理 器 ， 而 现在 谈论 的 却 是 处 理 器 函数 。 这 是 
有 意 而 为 之 的 一 一 尽管 处 理 器 和 处 理 器 函数 提供 的 最 终结 果 是 一 样 的 ， 
但 它们 实际 上 并 不 相同 。 本 书 的 第 3 章 将 对 处 理 器 和 处 理 器 函数 之 间 的 
区 别 做 进一步 的 说 明 ， 但 是 现在 让 我 们 暂时 先 忘 掉 这 件 事 ， 继 续 研究 
ChitChat 应 用 的 代码 实现 。 


2.4.2 ”服务 静态 文件 


除 负责 将 请 求 重 定向 到 相应 的 处 理 器 之 外 ， 多 路 复 用 器 还 需要 为 静 


态 文件 提供 服务 。 为 了 做 到 这 一 点 ， 程 序 使 用 FileServer 函数 创建 了 
一 个 能 够 为 指定 目录 中 的 静态 文件 服务 的 处 理 器 ， 并 将 这 个 处 理 器 传递 
给 了 多 路 复 用 器 的 Handle 函数 。 除 此 之 外 ， 程 序 还 使 用 StripPrefix 
函数 去 移 除 请 求 URL 中 的 指定 前 绥 : 


files := http.FileServer(http.Dir("/public")) 


mux.Handle("/static/", http.StripPrefix("/static/", files)) 





当 服 务 器 接收 到 一 个 以 /staticy 开头 的 UREL 请 求 时 ， 以 上 两 行 代 
人 码 会 移 除 URL 中 的 /static/ 字符 串 ， 然 后 在 public 目录 中 得 找 被 请 求 
的 文件 。 比 如 说 ， 当 服务 器 接收 到 一 个 针对 文件 
http://localhost/static/css/bootstrap.min.css 的 请 求 时 ， 它 
将 会 在 public 目录 中 查找 以 下 文件 : 


«application root»/css/bootstrap.min.css 


当 服 务 器 成 功 地 找到 这 个 文件 之 后 ， 会 把 它 返 回 给 客户 端 。 
2.4.3 ”创建 处 理 器 函数 


正如 之 前 的 小 节 所 说 ，ChitChat 应 用 会 通过 HandleFunc 函数 把 请 
求 重 定 癌 到 处 理 器 函数 。 正 如 代码 清单 2-2 所 示 ， 处 理 器 函数 实际 上 就 
是 一 个 接受 ResponseWriter 和 Request 指针 作为 参数 的 Go 函数 。 

















代码 清单 2-2 main. go 文件 中 的 index 处 理 器 函数 














func index(w http.ResponseWriter, r *http.Request) { 
files := []string("templates/layout.html", 
"templates/navbar.html", 
"templates/index.html",) 


templates := template.Must(template.ParseFiles(files...)) 
threads, err := data.Threads(); if err -- nil ( 
templates.ExecuteTemplate(w, "layout", threads) 
} 
} 





index 函数 负责 生成 HIML 并 将 其 写 入 ResponseWriter 中 。 因 为 
这 个 处 理 器 函数 会 用 到 html/template 标准 库 中 的 Template 结构 ， 所 
以 包含 这 个 函数 的 文件 需要 rodea DH RE [m 


之 后 的 小 节 将 对 生成 HTML 的 方法 做 进一步 的 介 


除了 前 面 提 到 过 的 负责 处 理 根 URL 请 求 的 jndex 处 理 器 函 
数 ，main.go 文件 实际 上 还 包含 很 多 其 他 的 处 理 器 函数 ， 如 代码 清单 2- 
3 所 示 。 





代码 清单 2-3 ”ChitChat 应 用 的 main. go 源 文件 








package main 


import ( 
"net/http" 
) 


func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir(config.Static)) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 


mux.HandleFunc("/", index) 
mux.HandleFunc("/err", err) 


mux.HandleFunc("/login", login) 
mux.HandleFunc("/logout", logout) 
mux.HandleFunc("/signup", signup) 
mux.HandleFunc("/signup account", signupAccount) 
mux.HandleFunc("/authenticate", authenticate) 


mux.HandleFunc("/thread/new", newThread) 


mux.HandleFunc("/thread/create", createThread) 
mux.HandleFunc("/thread/post", postThread) 
mux.HandleFunc("/thread/read", readThread) 


server := &http.Server( 
Addr: "0.0.0.0:8080", 
Handler: mux, 


server.ListenAndServe() 


} 





main 函数 中 使 用 的 这 些 处 理 器 函数 并 没有 在 main. go LFE 
义 ， 它 们 的 定义 在 其 他 文件 里 面 ， 具 体 请 参考 ChitChat 项 目的 完整 源 
码 。 


为 了 在 一 个 文件 里 面 引 用 另 一 个 文件 中 定义 的 函数 ， 诸 如 PHP、 
Ruby 和 Python 这 样 的 语言 要 求 用 户 编写 代码 去 包含 〈include) 被 引用 也 
数 所 在 的 文件 ， 而 另 一 些 语言 则 要 求 用 户 在 编译 程序 时 使 用 特殊 的 链接 


(link) 命令 。 








但 是 对 Go 语言 来 说 ， 用 户 只 需要 把 位 于 相同 目录 下 的 所 有 文件 都 
设置 成 同一 个 包 ， 那 么 这 些 文 件 就 会 与 包 中 的 其 他 文件 分 享 彼此 的 定 
义 。 又 或 者 ， 用 户 也 可 以 把 文件 放 到 其 他 独立 的 包 里 面 ， 然 后 通过 导入 
(import) 这些 包 来 使 用 它们 。 比 如 ，ChitChat 论 坛 束 把 连接 数据 库 的 
代码 放 到 了 独立 的 包 里 面 ， 我 们 很 快 就 会 看 到 这 一 点 。 





2.4.4 ”使 用 cookie 进 行 访问 控制 


跟 其 他 很 多 Web 应 用 一 样 ，ChitChat 既 拥有 任何 人 都 可 以 访问 的 公 
开 页 面 ， 也 拥有 用 户 在 登录 账号 之 后 才能 看 见 的 私人 页 面 。 














当 一 个 用 户 成 功 登录 以 后 ， 服 务 器 必须 在 后 续 的 请 求 中 标示 出 这 是 








一 个 已 登录 的 用 户 。 为 了 做 到 这 一 点 ， 服 务 器 会 在 响应 的 首部 中 号 入 一 
个 cookie， 而 客户 端 在 接收 这 个 cookie 之 后 则 会 把 它 存储 到 浏览 器 里 

面 。 代 码 清单 2-4 展 示 了 authenticate 处 理 器 函数 的 实现 代码 ， 这 个 函 
数 定义 在 route_auth .go 文件 中 ， 它 的 作用 就 是 对 用 户 的 身份 进行 验 
证 ， 并 在 验证 成 功 之 后 同 客 户 端 返回 一 个 cookie。 



































代码 清单 2-4 route auth.go 文件 中 的 authenticate 处 理 器 函数 








func authenticate(w http.ResponseWriter, r *http.Request) { 
r.ParseForm() 
user, _ := data.UserByEmail(r.PostFormValue("email")) 
if user.Password == data.Encrypt(r.PostFormValue("password")) { 
session :- user.CreateSession() 
cookie := http.Cookie( 
Name: " cookie", 
Value: session.Uuid, 


HttpOnly: true, 
} 
http.SetCookie(w, &cookie) 
http.Redirect(w, r, "/", 302) 
) else { 
http.Redirect(w, r, "/login", 302) 
} 





注意 ， 代 码 清单 2-4 中 的 authenticate 函数 使 用 了 两 个 我 们 尚未 介 
绍 过 的 函数 ， 一 个 是 data.Encrypt ， 而 另 一 个 则 
是 data.UserbyEmail 。 因 为 本 市 关注 的 是 ChitChat 论 坛 的 访问 控制 机 
制 而 不 是 数据 处 理 方法 ， 所 以 本 节 将 不 会 对 这 两 个 函数 的 实现 细节 进行 
解释 ， 但 这 两 个 函数 的 名 字 已 经 很 好 地 说 明了 它们 各 自 的 作 
用 : data.UserByEmail 函数 通过 给 定 的 电子 邮件 地 址 获取 与 之 对 应 的 
User 结构 ， 而 data.Encrypt 函数 则 用 于 加 密 给 定 的 字符 串 。 本 章 稍 
后 将 会 对 data 包 作 更 详细 的 介绍 ， 但 是 在 此 之 前 ， 让 我 们 回 到 对 访问 














控制 机 制 的 讨论 上 来 。 








在 验证 用 户 身 份 的 时 候 ， 程 序 必 须 先 确保 用 户 是 真实 存在 的 ， 并 且 
提交 给 处 理 器 的 密码 在 加 密 之 后 跟 存 储 在 数据 库 里 面 的 已 加 密 用 户 密 码 
完全 一 致 。 在 核实 了 用 户 的 身份 之 后 ， 程 序 会 使 用 User 结构 的 
CreateSession 方法 创建 一 个 session 结构 ， 该 结构 的 定义 如 下 : 








type Session struct { 
Id i 
Uuid 


Email 


UserId 
CreatedAt time.Time 





Session 结构 中 的 Email 字段 用 于 存储 用 户 的 电子 邮件 地 址 ， 
而 UserId 字段 则 用 于 记录 用 户 表 中 存储 用 户 信息 的 行 的 DD。Uuid 字段 
存储 的 是 一 个 随机 生成 的 唯一 ID， 这 个 ID 是 实现 会 话机 制 的 核心 ， 服 务 
器 会 通过 cookie 把 这 个 ID 存储 到 浏览 器 里 面 ， 并 把 session 结构 中 记录 
的 各 项 信息 存储 到 数据 库 中 。 





在 创建 了 Session 结构 之 后 ， 程 序 义 创建 了 Cookie 结构 : 


cookie := http.Cookie{ 
Name: " cookie", 
Value: session.Uuid, 


HttpOnly: true, 
} 











cookie 的 名 字 是 随意 设置 的 ， 而 cookie 的 值 则 是 将 要 被 存储 到 浏览 
器 里 面 的 唯一 ID。 因 为 程序 没有 给 cookie 设 置 过 期 时 间 ， 所 以 这 个 


cookie 束 成 了 一 个 会 话 cookie， 它 将 在 浏览 器 关闭 时 自动 被 移 除 。 

- 程序 将 HttpOnly 字段 的 值 设 置 成 了 true ， 这 意味 着 这 个 cookie 只 
E 通 过 HTTP 或 者 HITPS 访 问 ， 但 是 却 无 法 通过 JavaScript 等 非 HITP API 

oce) 


在 设置 好 cookie 之 后 ， 程 序 使 用 以 下 这 行 代码 ， 将 它 添加 到 了 响应 
的 首部 里 面 : 


http.SetCookie(writer, &cookie) 


在 将 cookie 存 储 到 浏览 器 里 面 之 后 ， 程 序 接 下 来 要 做 的 就 是 在 处 理 
器 函数 里 面 检查 当前 访问 的 用 户 是 否 已 经 登录 。 为 此 ， 我 们 需要 创建 一 
ee 的 工具 (utility〉 函 数 ， 并 在 各 个 处 理 器 函数 里 面 复 用 

。 代 码 清 单 2-5 展 示 了 session 函数 的 实现 代码 ， 跟 其 他 工具 函数 一 
这 个 函数 也 是 在 util. go 文件 里 面 定 义 的 。 再 提醒 一 下 ， 虽 然 程 序 
把 工具 函数 的 定义 都 放 在 了 util.go 文件 里 面 ， 但 是 因为 util.go 文件 
也 隶属 于 main 包 ， 所 以 这 个 文件 里 面 定 义 的 所 有 工具 函数 都 可 以 直接 
在 整个 main 包 里 面 调用 ， 而 不 必 像 data.Encrypt 函数 那样 需要 先 引 
入 包 然 后 再 调用 。 























代码 清单 2-5 util.go 文件 中 的 session 工具 函数 

















func session(w http.ResponseWriter, r *http.Request)(sess data.Session, er 
r 
error){ 
cookie, err := r.Cookie("_cookie") 
if err == nil { 
sess = data.Session{Uuid: cookie.Value} 
if ok, _ := sess.Check(); !ok { 
err = errors.New("Invalid session") 


} 


} 


return 


} 





为 了 从 请 求 中 取出 cookie，session 函数 使 用 了 以 下 代码 : 


cookie, err := r.Cookie(" cookie") 














如 果 cookie 不 存在 ， 那 么 很 明显 用 户 并 未 登录 ; 相反 ， 如 果 cookie 
存在 ， 那 么 session 函数 将 继续 进行 第 二 项 检查 一 一 访问 数据 库 并 核实 
iu Ps 否 存在 。 第 二 项 检查 是 通过 data.Session 函数 完成 
的 ， 这 个 函数 会 从 cookie 中 取出 会 话 并 调用 后 者 的 Check 方法 : 


sess = data.Session(Uuid: cookie.Value) 
if ok, _ := sess.Check(); !ok ( 


err - errors.New("Invalid session") 


} 











在 拥有 了 检查 和 识别 已 登录 用 户 和 未 登录 用 户 的 能 力 之 后 ， 让 我 们 
来 回顾 一 下 之 前 展示 的 index 处 理 器 函数 ， 代 码 清单 2-6 中 被 加 粗 的 代 
码 行 展示 了 这 个 处 理 器 函数 是 如 何 使 用 session 函数 的 。 





代码 清单 2-6”index 处 理 器 函数 





func index(w http.ResponseWriter, r *http.Request) { 
threads, err :- data.Threads(); if err -- nil ( 
, err := session(w, r) 


public tmpl files := []string("templates/layout.html", 
"templates/public.navbar.html", 
"templates/index.html") 

private tmpl files := []stringí("templates/layout.html", 


"templates/private.navbar.html", 
"templates/index.html") 
var templates *template.Template 
if err !- nil { 
templates - template.Must(template.Parse- 
Files(private tmpl files...)) 


) else { 
templates - template.Must(template.ParseFiles(public tmpl files...)) 
j 
templates.ExecuteTemplate(w, "layout", threads) 
} 


} 





通过 调用 session 疯 数 可 以 取得 一 个 存储 了 用 户 信 息 的 Session 结 
构 ， 不 过 因为 index 函数 目前 并 不 需要 这 些 信息 ， 所 以 它 使 用 空白 标识 
ff (blank identifier) (_) 忽略 了 这 一 结构 。index 函数 真正 感 兴趣 的 
是 err 变量 ， 程 序 会 根据 这 个 变量 的 值 来 判断 用 户 是 否 已 经 登录 ， 然 后 
以 此 来 选择 是 使 用 public 导航 条 还 是 使 用 private 导航 条 。 





好 的 ， 关 于 ChitChat 应 用 处 理 请 求 的 方法 就 介绍 到 这 里 了 。 本 章 接 
下 来 会 继续 讨论 如 何 为 客户 端 生成 HIML， 并 完整 地 叙述 之 前 没有 说 完 


的 部 分 。 





2.5 ”使 用 模板 生成 HIML 啊 应 





index 处 理 器 函数 里 面 的 大 部 分 代码 都 是 用 来 为 客户 端 生成 HIML 
的 。 首 先 ， 函 数 把 每 个 需要 用 到 的 模板 文件 都 放 到 了 Go 切片 里 面 〈 这 
里 展示 的 是 私有 页 面 的 模板 文件 ， 公 开 页 面 的 模板 文件 也 是 以 同样 方式 
进行 组 织 的 ) : 








private tmpl files := []stringí("templates/layout.html", 
"templates/private.navbar.html", 


"templates/index.html") 


跟 Mustache 和 CTemplate 等 其 他 模板 引擎 一 样 ， 切 片 指定 的 这 3 个 
HTML 文 件 都 包含 了 特定 的 舱 入 命令 ， 这 些 命令 被 称 为 动作 
(action? ， 动 作 在 HIML 文 件 里 面 会 被 {{ 符号 和 }} 符号 包围 。 


接着 ， 程 序 会 调用 ParseFiles 函数 对 这 些 模板 文件 进行 语法 分 
析 ， 并 创建 出 相应 的 模板 。 为 了 捕捉 语法 分 析 过 程 中 可 能 会 产生 的 错 
误 ， 程 序 使 用 了 Must 函数 去 包围 ParseFiles 函数 的 执行 结果 ， 这 样 
当 ParseFiles 返回 错误 的 时 候 ，Must 函数 就 会 向 用 户 返 回 相 应 的 错误 
报告 : 


templates := template.Must(template.ParseFiles(private tmpl files...)) 





好 的 ， 关 于 模板 文件 的 介绍 已 经 足够 多 了 ， 现 在 是 时 候 来 看 看 它们 
的 庐山 真面目 了 。 





ChitChat 论 坛 的 每 个 模板 文件 都 定义 了 一 个 模板 ， 这 种 做 法 并 不 是 
强制 的 ， 用 户 也 可 以 在 一 个 模板 文件 里 面 定义 多 个 模板 ， 但 模板 文件 和 
模板 一 一 对 应 的 做 法 可 以 给 开发 带 来 方便 ， 我 们 在 之 后 就 会 看 到 这 一 
点 。 代 码 清单 2-7 展 示 了 1ayout .html 模板 文件 的 源 代码 ， 源 代码 中 使 
用 了 define 动作 ， 这 个 动作 通过 文件 开头 的 {{ define "layout" 3) 
和 文件 末尾 的 {{ end )) ， 把 被 包围 的 文本 块 定义 成 了 layout 模板 的 


一 部 分 。 





代码 清单 2-7 layout .html 模板 文件 


{{ define "layout" }} 





<!DOCTYPE html» 
«html lang="en"> 
«head» 
«meta charset-"utf-8"» 
«meta http-equiv-z"X-UA-Compatible" content="IE=9"> 
«meta name-"viewport" content-"widthzdevice-width, initial-scale-1"» 
«title»ChitChat«/title» 
«link hrefz"/static/css/bootstrap.min.css" rel-"stylesheet"» 
«link hrefz"/static/css/font-awesome.min.css" rel-"stylesheet"» 
«/head» 
«body» 
(( template "navbar" . }} 


«div class-"container"» 
(( template "content" . }} 
«/div» «!-- /container --> 
«script src-"/static/js/jquery-2.1.1.min.js"»«/script» 
«script src-"/static/js/bootstrap.min.js"»«/script» 


«/body» 
</html> 


{{ end }} 





除了 define 动作 之 外 ，1layout .html 模板 文件 里 面 还 包含 了 两 个 
用 于 引用 其 他 模板 文件 的 template 动作 。 跟 在 被 引用 模板 名 字 之 后 的 
点 〈《. ) 代表 了 传递 给 被 引用 模板 的 数据 ， 比 如 {{ template 
"navbar" . jJ) 语句 除了 会 在 语句 出 现 的 位 置 引 入 navbar 模板 之 外 ， 
还 会 将 传递 给 layout 模板 的 数据 传递 给 navbar 模板 。 





代码 清单 2-8 展 示 了 public.navbar.html 模板 文件 中 的 navbar 模 
板 ， 除 了 定义 模板 自身 的 define 动作 之 外 ， 这 个 模板 没有 包含 其 他 动 
作 “【〈 严 格 来 说 ， 模 板 也 可 以 不 包含 任何 动作 ) 。 























代码 清单 2-8 public.navbar .html 模板 文件 








(( define "navbar" }} 


«div class-"navbar navbar-default navbar-static-top" role-"navigation"» 


«div class-"container"» 
«div class-"navbar-header"» 
«button type="button" class-"navbar-toggle collapsed" 
e data-toggle-"collapse" data-target-".navbar-collapse"» 
«span class-"sr-only"»Toggle navigation«/span» 
«span class-"icon-bar"»«/span» 
«span class-"icon-bar"»«/span» 
«span class-"icon-bar"»«/span» 
«/button» 
«a class-"navbar-brand" hrefz"/"» 
«i class="fa fa-comments-o"»«/i» 
ChitChat 
</a> 
</div> 
<div class="navbar-collapse collapse"> 
<ul class="nav navbar-nav"» 
<li><a href="/">Home</a></li> 
</ul> 
<ul class="nav navbar-nav navbar-right"> 
<li><a href="/login">Login</a></li> 
</ul> 
</div> 
</div> 
</div> 


{{ end }} 





最 后 ， 让 我 们 来 看 看 定义 在 index.html 模板 文件 中 的 content 模 
板 ， 代 码 清单 2-9 展 示 了 这 个 模板 的 源 代 码 。 注 意 ， 尽 管 之 前 展示 的 两 
个 模板 都 与 模板 文件 拥有 相同 的 名 字 ， 但 实际 上 模板 和 模板 文件 分 别 拥 











有 不 同 的 名 字 也 是 可 行 的 。 











代码 清单 2-9 index.html 模板 文件 











(( define "content" }} 


«p class-"lead"» 
«a hrefz"/thread/new"»Start a thread«/a» or join one below! 


«/p» 


(( range . jj 
«div class="panel panel-default"» 
«div class-"panel-heading"» 
«span class-"lead"» «i class="fa fa-comment-o"»«/i» (( .Topic ))«/sp 
an» 
</div> 
<div class="panel-body"> 
Started by {{ .User.Name }} - {{ .CreatedAtDate }} - {{ .NumReplies 
}} 
posts. 
<div class="pull-right"> 
«a href="/thread/read?id={{.Uuid }}">Read more«/a» 
</div> 
</div> 
</div> 


{{ end }} 


{{ end }} 








index.html 文件 里 面 的 代码 非常 有 趣 ， 特 别 值得 一 提 的 是 文件 里 
面包 含 了 几 个 以 点 号 〈. ) 开头 的 动作 ， 比 如 {{ .User.Name }} 和 {{ 
.CreatedAtDate }} ， 这 些 动作 的 作用 和 之 前 展示 过 的 index 处 理 器 
KAAR: 


threads, err := data.Threads(); if err == nil { 
templates.ExecuteTemplate(writer, "layout", threads) 


} 





在 以 下 这 行 代码 中 : 


templates.ExecuteTemplate(writer, "layout", threads) 


程序 通过 调用 ExecuteTemplate 函数 ， 执 行 (execute) 已 经 经 过 
语法 分 析 的 layout 模板 。 执 行 模板 意味 着 把 模板 文件 中 的 内 容 和 来 自 





其 他 渠道 的 数据 进行 合并 ， 然 后 生成 最 终 的 HTML 内容， 具体 过 程 如 图 


2-6 所 示 o 
(S i 
TUR 
并 数据 和 模板 来 生成 HTML 





图 2-6 ”模板 引擎 通过 合 


程序 之 所 以 对 layout 模板 而 不 是 navbar 模板 或 者 content 模板 进 
行 处 理 ， 是 因为 layout 模板 已 经 引用 了 其 他 两 个 模板 ， 所 以 执 
行 ]ayout 模板 就 会 导致 其 他 两 个 模板 也 被 执行 ， 由 此 产生 出 预期 的 
HTML。 但 是 ， 如 果 程 序 只 执行 havbar 模板 或 者 content 模板 ， 那 么 
程序 最 终 只 会 产生 出 预期 的 HTML 的 一 部 分 。 

现在 ， 你 应 该 已 经 明白 了 ， 点 号 〈. ) 代表 的 就 是 传 入 到 模板 里 面 
的 数据 (实际 上 还 不 仅 如 此 ， 接 下 来 的 小 节 会 对 这 方面 做 进一步 的 说 
Bj» 。 图 2-7 展 示 了 程序 根据 模板 生成 的 ChitChat 论 坛 的 样子 。 











localhost 


C2» ChitChat 


ØO How long does it take to write a book? 


ØO What does it take to write a forum application? 


图 2-7” ChitChat Web 应 用 示例 的 主页 
整理 代码 
因为 生成 HTML 的 代码 会 被 重复 执行 很 多 次 ， 所 以 我 们 决定 对 这 些 


代码 进行 一 些 整理 ， 并 将 它们 移 到 代码 清单 2-10 所 示 的 generateHTML 
函数 里 面 。 





代码 清单 2-10 generateHTML 函数 








func generateHTML(w http.ResponseWriter, data interface{}, fn 
var files []string 


for , file := range fn ( 


...String) { 


files = append(files, fmt.Sprintf("templates/As.html", file)) 
} 
templates := template.Must(template.ParseFiles(files...)) 
templates.ExecuteTemplate(writer, "layout", data) 


} 





generateHTML 函数 接受 一 个 ResponseNriter 、 一 些 数据 以 及 一 
系列 模板 文件 作为 参数 ， 然 后 对 给 定 的 模板 文件 进行 语法 分 析 。data 
参数 的 类 型 为 空 接 口 类 型 (empty interface type) ， 这 意味 着 该 参数 可 
以 接受 任何 类 型 的 值 作为 输入 。 刚 开始 接触 Go 语言 的 人 可 能 会 觉得 旬 
怪 一 一 Go 不 是 静态 编程 语言 吗 ， 它 为 什么 能 够 使 用 没有 类 型 限制 的 参 
数 ? 





但 实际 上 ，Go 程 序 可 以 通过 接口 Cinterface) 机 制 ， 巧 妙 地 绕 过 静 
态 编 程 语言 的 限制 ， 并 籍 此 获得 接受 多 种 不 同类 型 输入 的 能 力 。Go 语 
言 中 的 接口 由 一 系列 方法 构成 ， 并 且 每 个 接口 就 是 一 种 类 型 。 一 个 空 接 
口 就 是 一 个 空 集合 ， 这 意味 着 任何 类 型 都 可 以 成 为 一 个 衬 接 口 ， 也 就 是 
说 任何 类 型 的 值 都 可 以 传递 给 函数 作为 参数 。 








generateHTML 函数 的 最 后 一 个 参数 以 3 个 点 〈... FA, "EXE 
示 generateHTML 疯 数 是 一 个 可 变 参 数 函 数 Cvariadic function). ， 这 意 
味 着 这 个 函数 可 以 在 最 后 的 可 变 参 数 中 接受 零 个 或 任意 多 个 值 作为 参 
数 。generateHTML 函数 对 可 变 参 数 的 文 持 使 我 们 可 以 同时 将 任意 多 个 
模板 文件 传递 给 该 函数 。 在 Go 语言 里 面 ， 可 变 参 数 必 须 是 可 变 参数 函 
数 的 最 后 一 个 参数 。 


在 实现 了 generateHTML 函数 之 后 ， 让 我 们 回 过 头 来 ， 继 续 对 
index 处 理 器 函数 进行 整理 。 代 码 清单 2-11 展 示 了 经 过 整理 之 后 的 
index 处 理 器 函数 ， 现 在 它 看 上 去 更 整洁 了 。 




















代码 清单 2-11 index 处 理 器 函数 的 最 终 版 本 


func index(writer http.ResponseWriter, request *http.Request) { 














threads, err := data.Threads(); if err == nil ( 


|, err := session(writer, request) 
if err !- nil 
generateHTML(writer, threads, "layout", "public.navbar", "index") 
) else { 
generateHTML(writer, threads, "layout", "private.navbar", "index") 
} 
} 
} 








在 这 一 节 中 ， 我 们 学 习 了 很 多 关于 模板 的 基础 知识 ， 之 后 的 第 5 章 





将 对 模板 做 更 详细 的 介绍 。 但 是 在 此 之 前 ， 让 我 们 先 来 了 解 一 下 
ChitChat 应 用 使 用 的 数据 源 (data source) ， 并 厌 此 了 解 一 下 ChitChat 尽 
用 的 数据 是 如 何 与 模板 一 同 生 成 最 终 的 HTML 的 。 


2.6 ”安装 PostgreSQL 


在 本 章 以 及 后 续 几 章 中 ， 每 当 遇 到 需要 访问 关系 数据 库 的 场景 ， 我 
们 都 会 使 用 PostgreSQL。 在 开始 使 用 PostgreSQL 之 前 ， 我 们 首先 需要 学 
习 的 是 如 何 安装 并 运行 PostgreSQL， 以 及 如 何 创建 本 章 所 需 的 数据 库 。 


2.6.1 在 Linux 或 FreeBSD 系 统 上 安装 


www.postgresql.org/download 为 各 种 不 同 版 本 的 Linux 和 FreeBSD 都 
提供 了 预 编译 的 二 进 制 安装 包 ， 用 户 只 需要 下 载 其 中 一 个 安装 包 ， 然 后 
根据 指示 进行 安装 就 可 以 了 。 比 如 说 ， 通 过 执行 以 下 命令 ， 我 们 可 以 在 
Ubuntu 发 行 版 上 安装 Postgres: 


sudo apt-get install postgresql postgresql-contrib 





这 条 命令 除了 会 安装 postgres 包 之 外 ， 还 会 安装 附 加 的 工具 包 ， 
并 在 安装 完毕 之 后 启动 PostgreSQL 数 据 库 系统 。 


在 默认 情况 下 ，Postgres 会 创建 一 个 名 为 postgres 的 用 户 ， 并 将 其 
于 连接 服务 器 。 为 了 操作 方便 ， 你 也 可 以 使 用 自己 的 名 字 创 建 一 
Postgres 账 号 。 要 做 到 这 一 点 ， 首 先 需要 登入 Postgres 账 号 : 


sudo su postgres 


接着 使 用 createuser 命令 创建 一 个 PostgreSQL 账 号 : 


createuser -interactive 


最 后 ， 还 需要 使 用 createdb 命令 创建 以 你 的 账号 名 字 命 名 的 数据 
FE: 


createdb «YOUR ACCOUNT NAME» 


2.6.2 ”在 Mac OS X 系 统 上 安装 


要 在 Mac OS X 上 安装 PostgreSQL ， 最 简单 的 方法 是 使 用 
PostgresApp.com 提 供 的 Postgres 应 用 : 你 只 需要 把 网 站 上 提供 的 zip 压 缩 
包 下 载 下 来 ， 解 压 它 ， 然 后 把 Postgres.app 文件 拖 忠 到 自己 的 
Applications 文件 夹 里 面 就 可 以 了 。 启 动 Postgres .app 的 方法 跟 启 
动 其 他 Mac OS X 应 用 的 方法 完全 一 样 。Postgres.app 在 初次 启动 的 时 
候 会 初始 化 一 个 新 的 数据 库 集群 ， 并 为 自己 创建 一 个 数据 库 。 因 为 命令 
行 工 具 psql 也 包含 在 了 Postgres.app 里 面 ， 所 以 在 设置 好 正确 的 路 


径 之 后 ， 你 就 可 以 使 用 psql 访问 数据 库 了 。 设 置 路 径 的 工作 可 以 通过 
在 你 的 ~/ .profile 文件 或 者 ~/ .bashrc 文件 中 添加 以 下 代码 行 来 完成 
1]. 


export PATH-$PATH:/Applications/Postgres.app/Contents/Versions/9.4/bin 


2.6.3 在 Windows 系 统 上 安装 


因为 Windows 系 统 上 的 很 多 PostgreSQL 图 形 安 装 程序 都 会 把 一 切 安 
装 步 又 布置 妥当 ， 用 户 只 需要 进行 相应 的 设置 就 可 以 了 ， 所 以 在 
Windows 系 统 上 安装 PostgreSQL 也 是 非常 简单 和 直观 的 。 其 中 一 个 流行 
的 安装 程序 是 由 Enterprise DB 提供 的 : www.enterprisedb.com/products- 





services-training/pgdownload. 


除了 PostgreSQL 数 据 库 本 身 之 外 ， 安 闭 包 还 会 附带 诸如 pgAdmin 等 
工具 ， 以 便 用 户 通过 这 些 工 具 进行 后 续 的 配置 。 


2.7 ”连接 数据 库 








本 章 前 面 在 展示 ChitChat 应 用 的 设计 方案 时 ， 曾 经 提 到 过 ChitChat 
应 用 包含 了 4 种 数据 结构 。 虽 然 把 这 4 种 数据 结构 放 到 主 源 码 文 件 里 面 也 
是 可 以 的 ， 但 更 好 的 办 法 是 把 所 有 与 数据 相关 的 代码 都 放 到 另 一 个 包 里 
面 一 一 ChitChat 应 用 的 data 包 也 因此 应 运 而 生 。 





为 了 创建 data 包 ， 我 们 首先 需要 创建 一 个 名 为 data 的 子 目 录 ， 并 
创建 一 个 用 于 保存 所 有 帖子 相关 代码 的 thread.go 文件 〈 在 之 后 的 小 节 
里 面 ， 我 们 还 会 创建 一 个 用 于 保存 所 有 用 户 相 关 代 码 的 user .go X 








需要 用 到 data 包 的 时 候 〈 比 如 处 理 器 需要 
需要 通过 import 语句 导入 这 个 包 : 


import ( 
"github.com/sausheong/gwp/Chapter 2 Go ChitChat/chitchat/data" 


) 





代码 清单 2-12 展 示 了 定义 在 thread.go 文件 里 面 的 Thread 结构 ， 
这 个 结构 存储 了 与 帖子 有 关 的 各 种 信息 。 




















代码 清单 2-12 ”定义 在 thread.go 文件 里 面 的 Thread 结构 














package data 


import( 
"time" 
) 
type Thread struct { 
int 


string 

string 

int 
CreatedAt time.Time 


} 





正如 代码 清单 2-12 中 加 粗 显 示 的 代码 行 所 示 ， 文 件 的 包 名 现在 
是 data 而 不 再 是 main 了 ， 这 个 包 就 是 前 面 小 节 中 我 们 曾经 见 到 过 的 
data 包 。data 包 除 了 包含 与 数据 库 交 互 的 结构 和 代码 ， 还 包含 了 一 些 
与 数据 处 理 密 切 相 关 的 函数 。 隶 属于 其 他 包 的 程序 在 引用 data 包 中 定 
义 的 函数 、 结 构 或 者 其 他 东西 时 ， 必 须 在 被 引用 元 素 的 名 字 前 面 显 式 地 
加 上 data 这 个 包 名 。 比 如 说 ， 引 用 Thread 结构 就 需要 使 











用 data.Thread 这 个 名 字 ， 而 不 能 仅仅 使 用 Thread 这 个 名 字 。 


Thread 结构 应 该 与 创建 关系 数据 库 表 threads 时 使 用 的 数据 定义 
语言 (Data Definition Language, DDL ) 保持 一 致 。 因 为 threads 表 日 
前 尚未 存在 ， 所 以 我 们 必须 创建 这 个 表 以 及 容纳 该 表 的 数据 库 。 创 建 
chitchat 数据 库 的 工作 可 以 通过 执行 以 下 命令 来 完成 : 


createdb chitchat 


在 创建 数据 库 之 后 ， 我 们 就 可 以 通过 代码 清单 2-13 展 示 的 
setup.sql 文件 为 ChitChat 论 坛 创 建 相应 的 数据 库 表 了 。 


















































代码 清单 2-13 ”用 于 在 PostgreSQL 里 面 创建 数据 库 表 的 setup.sq1 文件 





create table users ( 


id serial primary key, 

uuid varchar(64) not null unique, 
name varchar(255), 

email varchar(255) not null unique, 


password | varchar(255) not null, 
created at timestamp not null 


) ; 

create table sessions ( 
id serial primary key, 
uuid varchar(64) not null unique, 
email varchar(255), 
user id integer references users(id), 
created at timestamp not null 

) ; 

create table threads ( 
id serial primary key, 
uuid varchar(64) not null unique, 
topic text, 
user id integer references users(id), 


created at timestamp not null 


)5 


create table posts ( 


id serial primary key, 

uuid varchar(64) not null unique, 
body text, 

user id integer references users(id), 


thread id integer references threads(id), 
created at timestamp not null 





运行 这 个 脚本 需要 用 到 psql 工具 ， 正 如 上 一 市 所 说 ， 这 个 工具 通 
向 会 随 独 PostgreSQL 一 同安 装 ， 所 以 你 只 需要 在 终端 里 面 执行 以 下 命令 
Stu] eA T: 


psql -f setup.sql -d chitchat 


如 果 一 切 正 常 ， 那 么 以 上 命令 将 在 chitchat 数据 库 中 创建 出 相应 
的 表 。 在 拥有 了 表 之 后 ， 程 序 束 必须 考虑 如 何 与 数据 库 进行 连接 以 及 如 
何 对 表 进 行 操作 了 。 为 此 ， 程 序 创建 了 一 个 名 为 Db 的 全 局 变量 ， 这 个 
全 局 变量 是 一 个 指针 ， 指 向 的 是 代表 数据 库 连 接 池 的 sq1.DB ， 而 后 续 
的 代码 则 会 使 用 这 个 Db 变量 来 执行 数据 库 碍 询 操作 。 代 码 清单 2-14 展 示 
了 Db 变量 在 data.go 文件 中 的 定义 ， 此 外 还 展示 了 一 个 用 于 在 Web 应 
用 局 动 时 对 Db 变量 进行 初始 化 的 init 函数 。 


























代码 清单 2-14 data.go 文件 中 的 Db 全 局 变量 以 及 init 函数 














Var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "dbname-chitchat sslmode-disable") 
if err != nil { 
log.Fatal(err) 
} 


return 
} 


现在 程序 已 经 拥有 了 结构 、 表 以 及 一 个 指向 数据 库 连 接 池 的 指针 ， 
接 下 来 要 考虑 的 是 如 何 连接 (conect) Thread 结构 和 threads K. 3E 
运 的 是 ， 要 做 到 这 一 点 并 不 困难 : 跟 ChitChat 应 用 的 其 他 部 分 一 样 ， 我 
们 只 需要 创建 能 够 在 结构 和 数据 库 之 间 互 动 的 函数 就 可 以 了 。 例 如 ， 为 
了 从 数据 库 里 面 取 出 所 有 帖子 并 将 其 返回 给 jndex 处 理 器 函数 ， 我 们 可 
以 使 用 thread.go 文件 中 定义 的 Threads 函数 ， 代 码 清单 2-15 给 出 了 这 
个 函数 的 定义 。 

















代码 清单 2-15 threads .go 文件 中 定义 的 Threads 函数 


func Threads() (threads []Thread, err error)( 


rows, err := Db.Query("SELECT id, uuid, topic, user id, created at FROM 


threads ORDER BY created at DESC") 
if err !- nil { 


return 


} 
for rows.Next() { 
th := Thread{} 


if err = rows.Scan(&th.Id, &th.Uuid, &th.Topic, &th.UserId, 


e &th.CreatedAt); err !- nil ( 
return 

} 

threads = append(threads, th) 


rows.Close() 
return 





简单 来 讲 ，Threads 函数 执行 了 以 下 工作 : 


(1) 通过 数据 库 连 接 池 与 数据 库 进行 连接 ; 


(20 问 数 据 库 发 送 一 个 SQL 查询， 这 个 查询 将 返回 一 个 或 多 个 行 
作为 结果 ; 


(3) 遍历 行 ， 为 每 个 行 分 别 创建 一 个 Thread 结构 ， 首 先 使 用 这 个 
结构 去 存储 行 中 记录 的 帖子 数据 ， 然 后 将 存储 了 帖子 数据 的 Thread £i 
构 追 加 到 传 入 的 threads 切片 里 面 ; 





(40 重复 执行 步骤 3， 直 到 查询 返回 的 所 有 行 都 被 过 有 历 完毕 为 止 。 





本 书 的 第 6 章 将 对 数据 库 操作 的 细节 做 进一步 的 介绍 。 


在 了 解 了 如 何 将 数据 库 表 存储 的 帖子 数据 提取 到 Thread 结构 里 面 
之 后 ， 我 们 接 下 来 要 考虑 的 就 是 如 何在 模板 里 面 展 示 Thread 结构 存储 
的 数据 了 。 在 代码 清单 2-9 中 展示 的 index.html 模 板 文件 ， 有 这 样 一 段 代 
[m 





(( range . }} 
«div class="panel panel-default"» 
«div class-"panel-heading"» 
«span class-"lead"» «i class="fa fa-comment-o"»«/i» (( .Topic ))«/sp 


an» 
</div> 
<div class="panel-body"> 
Started by {{ .User.Name }} - {{ .CreatedAtDate }} - {{ .NumReplies 


}} 
posts. 
<div class="pull-right"> 
«a href="/thread/read?id={{.Uuid }}">Read more«/a» 
</div> 
</div> 
</div> 


{{ end }} 





正如 之 前 所 说 ， 模 板 动作 中 的 点 号. ) 代表 传 入 模板 的 数据 ， 它 


们 会 和 模板 一 起 生成 最 终 的 结果 ， 而 {{ range . )) 中 的 . 号 代表 的 是 
程序 在 稍 早 之 前 通过 Threads 函数 取得 的 threads 变量 ， 也 就 是 一 个 
由 Thread 结构 组 成 的 切片 。 


range 动作 假设 传 入 的 数据 要 么 是 一 个 由 结构 组 成 的 切片 ， 要 么 是 
一 个 由 结构 组 成 的 数组 ， 这 个 动作 会 届 历 传 入 的 每 个 结构 ， 而 用 户 则 可 
以 通过 字段 名 访问 结构 里 面 的 字段 ， 比 如 ， 动 作 {{ .Topic y) 访问 的 
是 Thread 结构 的 Topic 字段 。 注 意 ， 在 访问 字段 时 必须 在 字段 名 的 前 
面 加 上 点 号 ， 并 且 字 段 名 的 首 字 母 必 须 大 与 。 














用 户 除 可 以 在 字段 名 的 前 面 加 上 点 号 来 访问 结构 中 的 字段 以 外 ， 还 
可 以 通过 相同 的 方法 调用 一 种 名 为 方法 (method) 的 特殊 函数 。 比 
如 ， 在 上 面 展示 的 代码 中 ，{{ .User.Name }}、{{ 
.CreatedAtDate }} 和 {{ .NumReplies }} 这 些 动作 的 作用 就 是 调用 
结构 中 的 同名 方法 ， 而 不 是 访问 结构 中 的 字段 。 








方法 是 隶属 于 特定 类 型 的 函数 ， 指 针 、 接 口 以 及 包括 结构 在 内 的 所 
有 有 具名 类 型 都 可 以 拥有 自己 的 方法 。 比 如 说 ， 通 过 将 函数 与 指 
回 Thread 结构 的 指针 进行 绑 定 ， 可 以 创建 出 一 个 针对 Thread 结构 的 方 
法 ， 而 传 入 方法 里 面 的 Thread 结构 则 称 为 接收 者 (receiver) : 方法 可 
以 访问 接收 者 ， 也 可 以 修改 接收 者 。 


作为 例子 ， 代 码 清单 2-16 展 示 了 NumReplies 方法 的 实现 代码 。 








代码 清单 2-16 thread.go 文件 中 的 NumReplies 方法 








func (thread *Thread) NumReplies() (count int) { 
rows, err := Db.Query("SELECT count(*) FROM posts where thread id = $1", 
thread.Id) 


if err != nil { 
return 


for rows.Next() ( 


if err = rows.Scan(&count); err !- nil ( 
return 


} 


rows.Close() 
return 


} 





NumReplies 方法 首先 打开 一 个 指 疝 数据 库 的 连接 ， 接 看 通过 执行 





一 条 SQL 碍 询 来 取得 帖子 的 数量 ， 并 使 用 传 入 方法 里 面 的 count 参数 来 
记录 这 个 值 。 最 后 ，NumReplies 方法 返回 帖子 的 数量 作为 方法 的 执行 

结 末 ， 而 模板 引擎 则 使 用 这 个 值 去 代 蔡 模板 文件 中 出 现 的 {{ 
.NumReplies )) 动作 。 


通过 为 User 、Session Thread 和 Post 这 4 种 数据 结构 创建 相应 
的 函数 和 方法 ，ChitChat 最 终 在 处 理 器 函数 和 数据 库 之 间 构 建 起 了 一 个 
数据 层 ， 以 此 来 避免 处 理 器 函数 直接 对 数据 库 进 行 访问 ， 图 2-8 展 示 了 
这 个 数据 层 和 数据 库 以 及 处 理 器 函数 之 间 的 关系 。 虽 然 有 很 多 库 都 可 以 
达到 同样 的 效果 ， 但 亲自 构建 数据 层 能 够 帮助 我 们 学 习 如 何 对 数据 库 进 
行 基本 的 访问 ， 人 只 需要 用 到 一 些 
简单 直接 的 代码 ， 这 一 点 是 非常 有 益 的 。 














图 2-8 ”通过 结构 模型 连接 数据 库 和 处 理 器 
2.8 ”启动 服务 器 


在 本 章 的 最 后 ， 让 我 们 来 看 一 下 ChitChat 应 用 是 如 何 启 动 服务 器 并 
将 多 路 复 用 器 与 服务 器 进行 绑 定 的 。 执 行 这 一 工作 的 代码 是 在 main.go 
文件 里 面 定 义 的 : 
server := &http.Server( 


Addr: "0.0.0.0:8080", 
Handler: mux, 


server.ListenAndServe() 





这 段 代 码 非常 简单 ， 它 所 做 的 就 是 创建 一 个 Server 结构 ， 然 后 在 


这 个 结构 上 调用 ListenAndServe 方法 ， 这 样 服务 器 就 能 够 启动 了 。 


现在 ， 我 们 可 以 通过 执行 以 下 命令 来 编译 并 运行 ChitChat 心 用 : 


go build 


这 个 命令 会 在 当前 目录 以 及 $GOPATH/bin 目录 中 创建 一 个 名 
为 chitchat 的 二 进 制 可 执行 文件 ， 它 就 是 ChitChat 应 用 的 服务 器 。 接 
着 ， 我 们 可 以 通过 执行 以 下 命令 来 启动 这 个 服务 器 


./ chitchat 


如 果 你 已 经 按照 之 前 所 说 的 方法 ， 在 数据 库 里 面 创建 了 ChitChatY 
用 所 需 的 数据 库 表 ， 那 么 现在 你 只 需要 访问 http://localhost:8080/ 并 注册 
一 个 新 账号 ， 然 后 就 可 以 使 用 上 自己 的 账号 在 论坛 上 发 布 新 帖子 了 。 








2.9 ”Web 应 用 运作 流程 回顾 


在 本 章 的 各 节 中 ， 我 们 对 一 个 Go Web 应 用 的 不 同 组 成 部 分 进行 了 
初步 的 了 解 和 观察 。 图 2-9 对 整个 应 用 的 工作 流程 进行 了 介绍 ， 其 中 包 
括 : 





D 客户 端 问 服务 器 及 送 请 求 ; 
(2) 多 路 复 用 需 接 收 到 请 求 ， 并 将 其 重 定 癌 到 正确 的 处 理 器 


(3) 处 理 器 对 请 求 进行 处 理 ; 





(4) 在 需要 访问 数据 库 的 情况 下 ， 处 理 需 会 使 用 一 个 或 多 个 数据 
结构 ， 这 些 数据 结构 都 是 根据 数据 库 中 的 数据 建 模 而 来 的 ; 

















(5) 当 处 理 需 调用 与 数据 结构 有 关 的 函数 或 者 方法 时 ， 这 些 数 据 
结构 背后 的 模型 会 与 数据 库 进 行 连接 ， 并 执行 相应 的 操作 ; 


(60 当 请 求 处 理 完毕 时 ， 处 理 器 会 调用 模板 引擎 ， 有 时 候 还 会 癌 
模板 引擎 传递 一 些 通 过 模型 获取 到 的 数据 ; 


C7) 模板 引擎 会 对 模板 文件 进行 语法 分 析 并 创建 相应 的 模板 ， 而 
这 些 模板 义 会 与 处 理 需 传递 的 数据 一 起 合并 生成 最 终 的 HIML; 


(8) 生成 的 HTML 会 作为 啊 应 的 一 部 分 回 传 至 客户 端 。 








主要 的 步骤 大 概 就 是 这 些 。 在 接 下 来 的 几 章 中 ， 我 们 会 更 加 深入 地 
学 习 这 一 工作 流程 ， 并 进一步 了 解 该 流程 涉及 的 各 个 组 件 。 


2.10 小结 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 

多 路 复 用 器 会 将 HTTP 请 求 重 定 问 到 正确 的 处 理 器 进行 处 理 ， 针 对 
静态 文件 的 请 求 也 是 如 此 。 

处 理 絮 函数 是 一 种 接受 ResponseWriter 和 Requeest 指针 作为 参 : 
的 Go 函数 。 

cookie 可 以 用 作 一 种 访问 控制 机 制 。 

对 模板 文件 以 及 数据 进行 语法 分 析 会 产生 相应 的 HTML， 这 些 
HTML 会 被 用 作 返 回 给 浏览 器 的 啊 应 数据 。 

通过 使 用 sql 包 以 及 相应 的 SQL 语 句 ， 用 户 可 以 将 数据 持久 地 存储 
在 关系 数据 库 中 。 





[1] 在 安装 Postgres.app 时 ， 你 可 能 需要 根据 Postgres.app 的 版 本 对 
路 径 的 版 本 部 分 做 相应 的 修改 ， 比 如 ， 将 其 中 的 9.4 修改 为 9.5 或 
者 9.6 ， 诸 如 此 类 。 一 一 译 者 注 


第 二 部 分 “Web 应 用 的 基本 组 成 部 分 





所 有 Web 应 用 都 齐 循 一 个 简单 的 请 求 与 啊 应 编程 模型 ， 客 户 端 发 送 
的 每 个 请 求 都 会 接收 到 一 个 来 目 服务 器 的 啊 应 。 每 个 Web 应 用 都 会 包含 
几 个 基本 组 件 ， 其 中 路 由 器 负责 将 请 求 转 发 至 不 同 的 处 理 器 ， 处 理 器 负 
员 对 请 求 进行 处 理 ， 而 模板 引擎 则 会 根据 静态 文件 和 动态 数据 生成 返回 
给 客户 端的 数据 。 











在 接 下 来 的 第 3 章 到 第 6 音 ， 我 们 将 学 习 如 何在 Go 语言 里 面 使 用 路 
由 器 去 接收 HTTP 请 求 ， 如 何 使 用 处 理 器 去 处 理 请 求 ， 以 及 如 何 使 用 模 
板 引 擎 去 创建 啊 应 数据 。 因 为 大 部 分 Web 应 用 都 会 以 菏 种 方式 存储 数 
据 ， 所 以 我 们 还 会 学 习 如 何 使 用 Go 语言 对 数据 进行 持久 化 。 


第 3 草 ”接收 请 求 


本 章 主要 内 容 


e Go 语言 的 net/http 标准 库 的 使 用 方法 

。 通过 net/http 库 提供 HTTP 服 务 的 方法 
。 关于 处 理 器 以 及 处 理 器 函数 的 更 详细 信息 
。 在 服务 器 上 使 用 多 路 复 用 器 的 方法 


在 第 2 章 中 ， 我 们 看 到 了 一 个 简单 的 网 上 论坛 Web 应 用 是 由 什么 组 
件 构成 的 ， 也 了 解 到 了 这 些 组 件 是 如 何 组 织 成 一 个 Go Web 应 用 的 。 虽 
然 我 们 已 经 对 构成 Go Web 应 用 的 各 个 组 件 有 了 基本 的 了 解 ， 但 关于 这 
些 组 件 还 有 很 多 值得 深入 的 事情 。 在 接 下 来 的 儿童 里 ， 我 们 将 更 为 深入 
地 了 解 这 些 组 件 的 细 市 ， 并 详细 地 探讨 这 些 组 件 是 如 何 组 合 起 来 的 。 





本 章 和 下 一 章 将 对 Web 应 用 的 “大 脑 * (也 就 是 负责 接收 和 处 理 客户 
端 请 求 的 处 理 器 ) 进行 讨论 。 在 本 章 中 ， 我 们 将 要 学 习 的 是 如 何 使 用 
Go 语言 去 创建 一 个 web 服务器， 以 及 如 何 处 理 客户 端 发 送 的 请 求 。 


3.1 ”Go 的 net/http 标 准 库 
在 进行 Web 应 用 开发 的 时 候 ， 使 用 成 熟 并 且 复杂 的 Web 应 用 框架 通 


常会 使 开发 变 得 更 加 迅速 和 简便 ， 但 这 也 意味 着 开发 者 必须 接受 框 染 目 
身 的 一 套 约定 和 模式 。 昌 然 很 多 框架 都 认为 自己 提供 的 约定 和 模式 是 最 


佳 实践 〈best practice) ， 但 是 如 果 开 发 者 没有 正确 地 理解 这 些 最 佳 实 
践 ， 那 么 对 最 佳 实践 的 应 用 就 可 能 会 发 展 为 货物 崇拜 编程 (cargo cult 
programming) : 开发 者 如 果 不 了 解 这 些 约定 和 模式 的 用 法 ， 就 可 能 会 
在 不 必要 甚至 有 害 的 情况 下 盲目 地 使 用 它们 。 





货物 打 拜 编程 








第 二 次 世界 大 战 期 间 ， 盟 军 为 了 对 战事 提供 支援 ， 在 太平 洋 的 多 个 岛屿 上 设立 了 空军 基 
地 ， 以 空投 的 方式 向 部 队 以 及 支援 部 队 的 岛 民 投 送 了 大 量 生 活用 品 以 及 军事 设备 ， 从 而 极 大 
f 






































地 改善 了 部 队 以 及 咏 民 的 生活 ， 岛 民 也 因此 第 一 次 看 到 了 人 工 生产 的 衣物 、 饶 头 食品 以 及 
也 物品 。 在 战争 结束 之 后 ， 这 些 空 E SR AHALE. Jet, EE 
做 了 一 件 非 常 符 合 其 本 性 的 事情 空 管 员 、 士 兵 以 及 水 手 ， 使 用 机 场 上 
的 指挥 棒 挥 舞 着 着 陆 信和 号， 进行 地 面 阅 兵 演习 ， 试 图 让 飞机 继续 空投 货物 ， 货 物 尝 和 拜 一 词 也 
因此 而 诞生 。 





































































































尽管 货物 崇拜 程序 员 并 没有 像 鸟 民 一 样 挥 舞 指挥 棒 ， 但 他 们 却 大 量 地 复制 和 粘贴 从 
StackOverflow 这 类 网 站 上 找 来 的 代码 ， 这 些 代码 虽然 能 够 运行 ， 但 是 他 们 却 对 这 些 代码 的 工 
作 原 理 一 点 也 不 了 解 。 这 样 做 的 结果 是 ， 他 们 通常 无 法 扩展 和 修改 这 些 代码 。 与 此 类 似 ， 货 
物 稼 拜 程序 员 通 常会 在 既 不 了 解 框架 为 什么 使 用 特定 的 模式 或 约定 ， 也 不 知道 框架 做 了 何 和 也 
取 售 的 情况 下 ， 谊 目地 使 用 Web 框 架 。 

















































































































举 个 例子 来 说 ， 因 为 HITP 是 一 种 无 连接 协议 〈connection-less 
protocol) ， 通 过 这 种 协议 发 送 给 服务 器 的 请 求 对 服务 器 之 前 处 理 过 的 
请 求 一 无 所 知 ， 所 以 应 用 程序 才 会 以 cookie 的 方式 在 客户 端 实 现 数据 持 
入 化 ， 并 以 会 话 的 方式 在 服务 器 上 实现 数据 持久 化 ， 而 不 了 解 这 一 点 的 
人 是 很 难 理解 为 什么 要 在 不 同 连 接 之 间 使 用 cookie 和 会 话 实现 信息 持久 
化 的 。 为 了 降低 使 用 cookie 和 会 话 融 来 的 复杂 性 ，Web 应 用 框架 通常 都 
会 提供 一 个 统一 的 接口 ‘uniform interface) ， 用 于 在 连接 之 间 实 现 持久 
化 。 这 样 做 的 结果 是 ， 很 多 新 手 程序 员 都 会 想当然 地 假设 在 连接 之 间 进 





行 持久 化 唯一 要 做 的 就 是 使 用 框架 提供 的 接口 。 但 是 由 于 这 类 接口 通常 
都 是 根据 框架 自身 的 习惯 制定 的 ， 因 此 不 同 框架 提供 的 接口 可 能 会 有 所 
不 同 。 更 糟 料 的 是 ， 不 同 的 框 染 可 能 会 提供 一 些 名 字 相 同 的 接口 ， 但 是 
这 些 同名 接口 之 间 的 实现 却 又 千差万别 、 各 不 相同 ， 因 此 给 开发 者 带 来 
不 必要 的 困惑 。 通 过 这 个 例子 可 以 看 出 ， 使 用 框架 进行 Web 应 用 开 友 意 
味 着 将 框架 与 应 用 进行 绑 定 ， 之 后 无 论 是 将 应 用 迁移 至 为 一 个 框架 ， 还 
古 对 应 用 进行 扩展 ， 叉 或 者 为 应 用 添加 新 的 特性 ， 都 需要 对 框架 本 里 有 
深入 的 了 解 ， 在 东 些 情况 下 可 能 还 需要 对 框架 进行 定制 。 








本 书 的 目的 并 不 是 让 大 家 抛弃 框架 、 约 定 和 模式 一 一 一 个 好 的 框 染 
通常 是 快速 构建 可 扩展 且 健 壮 的 Web 应 用 的 最 好 方法 ， 但 理解 那些 隐藏 
在 框架 之 下 的 底层 概念 和 基础 设施 也 是 非常 重要 的 。 只 要 对 框 染 的 实现 
原理 有 了 正确 的 认识 ， 我 们 束 可 以 更 加 清晰 地 了 解 到 这 些 约定 和 模式 十 
如 何 形成 的 ， 从 而 避免 陷阱 、 理 清 思 路 ， 不 再 盲目 地 使 用 模式 。 





对 Go 语言 来 说 ， 隐 藏 在 框架 之 下 的 通常 是 net/http 和 
html/template 这 两 个 标准 库 ， 本 章 和 接 下 来 的 第 4 章 将 介绍 
net/http 库 ， 而 之 后 的 第 5 章 将 介绍 html/template FE. 


如 图 3-1 所 示 ，net/http 标准 库 可 以 分 为 客户 器 和 服务 需 两 个 部 
分 ， 库 中 的 结构 和 函数 有 些 只 文 持 客户 端 和 服务 器 这 两 者 中 的 一 个 ， 而 
有 些 则 同时 文 持 客户 端 和 服务 器 : 





e Client, Response 、Header 、Request 和 Cookie 对 客户 端 进 和 
支持 ; 


e Server , ServeMux . Handler/HandleFunc . ResponseWriter 


. Header 、Request 和 Cookie 则 对 服务 器 进行 支持 。 


本 章 接 下 来 将 会 展示 如 何 把 net/http 标准 库 用 作 服 务 器 以 及 如 何 
使 用 Go 语言 接收 客户 端 发 送 的 HTTP 请 求 。 在 之 后 的 第 4 章 ， 我 们 还 会 
继续 使 用 net/http 标准 库 ， 但 焦点 会 放 在 如 何 处 理 请 求 上 面 。 


在 本 书 中 ， 我 们 主要 关注 的 是 如 何 使 用 net/http 标准 库 的 服务 器 
功能 而 非 客 户 问 功 能 。 


服务 器 


ResponseWriter 


Handler/HandlerFunc 


Request 


ServeMux 





图 3-1 net/http 标准 库 的 各 个 组 成 部 分 


3.2 ”使 用 Go 构建 服务 堪 


如 图 3-2 所 示 ， 通 过 net/http 标准 库 ， 我 们 可 以 局 动 一 个 HTTP 服 
务 器 ， 然 后 让 这 个 服务 器 接收 请 求 并 回 请 求 返 回响 应 。 除 此 之 
外 ，net/http 标准 库 还 提供 了 一 个 连接 多 路 复 用 器 (multiplexer) 的 
接口 以 及 一 个 默认 的 多 路 复 用 器 。 























图 3-2 通过 Go 服务 器 处 理 请 求 











3.2.1 Go Web 服 务 器 


跟 其 他 编程 语言 里 面 的 绝 大 多 数 标准 库 不 一 样 ，Go 提 供 了 一 系列 
用 于 创建 Web 服 务 器 的 标准 库 。 正 如 代码 清单 3-1 所 示 ， 创 建 一 个 服务 
器 的 步骤 非常 简单 ， 只 要 调用 ListenAndServe 并 传 入 网 络 地 址 以 及 负 
责 处 理 请 求 的 处 理 器 Chandler) 作为 参数 就 可 以 了 。 如 果 网 络 地 址 参数 
为 空 字符 串 ， 那 么 服务 器 默认 使 用 80 端 口 进行 网 络 连接 ， 如 果 处 理 器 参 
数 为 nil ， 那 么 服务 器 将 使 用 默认 的 多 路 复 用 器 DefaultserveMux 。 


代码 清单 3-1 最 简单 的 Web 服 务 器 
package main 
import ( 


"net/http" 
) 


func main() { 
http.ListenAndServe("", nil) 





用 户 除 了 可 以 通过 ListenAndServe 的 参数 对 服务 器 的 网 络 地 址 和 
处 理 器 进行 配置 之 外 ， 还 可 以 通过 server 结构 对 服务 器 进行 更 详细 的 
配置 ， 其 中 包括 为 请 求 读 取 操 作 设 置 超时 时 间 、 为 响应 写 入 操作 设置 超 
时 时 间 以 及 为 Server 结构 设置 错误 日 志 记 录 器 等 。 











代码 清单 3-2 和 代码 清单 3-1 的 作用 基本 上 有 是 相同 的 ， 它 们 之 间 的 唯 
一 区 别 在 于 代码 清单 3-2 可 以 通过 Server 结构 对 服务 器 进行 更 多 的 配 
置 。 

















代码 清单 3-2 ”人 带 有 附加 配置 的 web 服务 器 


package main 


import ( 
"net/http" 
) 


func main() { 


server :- http.Server( 
Addr: "127.0.0.1:8080", 
Handler: nil, 

} 

server.ListenAndServe() 


} 





代码 清单 3-3 展 示 了 Server 结构 所 有 可 选 的 配置 选项 。 





代码 清单 3-3 Server 结构 的 配置 选项 











type Server struct { 


Addr string 
Handler Handler 
ReadTimeout time.Duration 


WriteTimeout ^ time.Duration 

MaxHeaderBytes int 

TLSConfig *tls.Config 

TLSNextProto | map[string]func(*Server, *tls.Conn, Handler) 


ConnState func(net.Conn, ConnState) 
ErrorLog *log.Logger 
} 





3.2/2 ”通过 HTTPS 提 供 服务 





当 客 户 端 和 服务 器 需要 共享 密码 或 者 信用 卡 信息 这 样 的 私密 信息 
时 ， 大 多 数 网 站 都 会 使 用 HTTPS 对 客户 端 和 服务 器 之 间 的 通信 进行 加 密 
和 保护 。 在 一 些 情况 下 ， 这 种 保护 甚至 是 强制 性 的 。 比 如 说 ， 如 果 一 个 
网 站 提供 了 信用 卡 文 付 功能 ， 那 么 按照 支付 卡 行业 数据 安全 标准 
(Payment Card Industry Data Security Standard) ， 这 个 网 站 就 必须 对 客 
户 症 和 服务 器 之 间 的 通信 进行 加 密 。 像 Gmail 和 Facebook 这 样 带 有 隐私 
性 质 的 网 站 甚至 在 整个 网 站 上 都 局 用 了 HITPS。 如 采 你 打算 开发 一 个 网 
站 ， 而 这 个 网 站 又 需要 提供 用 户 登 录 功 能 ， 那 么 你 也 需要 在 这 个 网 站 上 
启用 HTTPS。 





HTTPS 实 际 上 就 是 将 HTTP 通 信 放 到 SSL 之 上 进行 。 通 过 使 
用 ListenAndServeTLS 函数 ， 我 们 可 以 让 之 前 展示 过 的 简单 Web 应 用 
也 提供 HTTPS 服 务 ， 代 码 清单 3-4 展 示 了 具体 的 实现 代码 。 











代码 清单 3-4 通过 HTTPS 提 供 服务 














package main 


import ( 
"net/http" 
) 


func main() { 
server :- http.Server( 
Addr: "127.0.0.1:8080", 
Handler: nil, 
j 


server.ListenAndServeTLS("cert.pem", "key.pem") 


} 
这 段 代码 中 的 cert.pem 文件 是 SSL 证 书 ， 而 key .pem 则 是 服务 器 
的 私 钥 (private key) 。 在 生产 环境 中 使 用 的 SSL 证 书 需要 通过 
VeriSign、Thawte 或 者 Comodo SSL 这 样 的 CA 取得 ， 但 如 果 是 出 于 测试 
目的 才 使 用 证 书 和 私 铀 ， 那 么 使 用 自行 生成 的 证 书 就 可 以 了 。 生 成 证 书 
的 办 法 有 很 多 种 ， 其 中 一 种 就 是 使 用 Go 标准 库 中 的 crypto 包 群 
(library group) 。 


SSL (Secure Socket Layer， 安 全 套 接 字 层 ) 是 一 种 通过 公 钥 基础 设施 (Public E 
Infrastructure，PKI) 为 通信 双方 提供 数据 加 密 和 和 里 份 验证 的 协议 ， 其 中 通信 的 双方 通常 
户 端 和 服务 器 。SSL 最 初 由 Netscape 公 司 开 发 ， 之 后 由 IETF (nternet Engineering Task Force, 
互联 网 工程 任务 组 ) 接手 并 将 其 改名 为 TLS〈Transport Layer Security， 传 输 层 安全 协议 ) 。 
HTTPS， 即 SSL 之 上 的 HITP， 实 际 上 就 是 在 SSL/TLS 连 接 的 上 层 进行 HTTP 通 信 。 





















































HTTPS 需 要 使 用 SSL/TLS 证 书 来 实现 数据 加 密 以 及 身份 验证 (本 书 使 用 SSL 证 书 这 一 名 
称 ， 因 为 它 更 常用 ) 。SSL 证 书 存储 在 服务 器 之 上 ， 它 是 一 种 使 用 X.509 格 式 进 行 格式 化 的 数 
据 ， 这 些 数据 包含 了 公 钥 以 及 其 他 一 些 相关 信息 。 为 了 保证 证 书 的 可 靠 性 ， 证 书 一 般 由 证 书 
分 发 机 构 (Certificate Authority, CAO 签发 。 服 务 器 在 接收 到 客户 端 发 送 的 请 求 之 后 ， 会 将 证 
书 和 响应 一 并 返回 给 客户 端 ， 而 客户 端 在 确认 证 书 的 真实 性 之 后 ， 就 会 生成 一 个 随机 密 钥 
(random key) ， 并 使 用 证 书 中 的 公 钥 对 随机 密 钥 进行 加 密 ， 此 次 加 密 产生 的 对 称 密 铀 
(symmetric key) 就 是 客户 端 和 服务 器 在 进行 通信 时 ， 负 责 对 通信 实施 加 密 的 实际 密 铀 
Cactual key) 。 


























































































































虽然 我 们 不 会 在 生产 环境 中 使 用 自行 生成 的 证 书 和 私 铀 ， 但 了 解 
SSL 证 书 和 私 钥 的 生成 方法 ， 并 学 会 如 何在 开发 和 测试 的 过 程 中 使 用 证 
书 和 私 钥 ， 也 是 一 件 非 常 有 意义 的 事情 。 代 码 清单 3-5 展 示 了 生成 SSL 证 
书 以 及 服务 器 私 钥 的 具体 代码 。 
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代码 清单 3-5 ”生成 个 人 使 用 的 SSL 证 书 以 及 服务 嚣 私 钥 























package main 


import ( 
"crypto/rand" 
"crypto/rsa" 
"crypto/x509" 
"crypto/x509/pkix" 
"encoding/pem" 
"math/big" 
"net" 


) 


func main() { 
max :- new(big.Int).Lsh(big.NewInt(1), 128) 


serialNumber, _ := rand.Int(rand.Reader, max) 

subject := pkix.Name( 
Organization: []string("Manning Publications Co."), 
OrganizationalUnit: []string["Books"), 
CommonName : "Go Web Programming", 

} 


template := x509.Certificate( 
SerialNumber: serialNumber, 


Subject: subject, 

NotBefore: time.Now(), 

NotAfter: time.Now().Add(365 * 24 * time.Hour), 

KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSi 
gnature, 


ExtKeyUsage: []x509.ExtKeyUsage(x509.ExtKeyUsageServerAuth), 
IPAddresses: []net.IP[net.ParseIP("127.0.0.1")), 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, 
we&template, &pk.PublicKey, pk) 

certOut, _ := os.Create("cert.pem") 

pem.Encode(certOut, &pem.Block(Type: "CERTIFICATE", Bytes: derBytes}) 
certOut.Close() 


keyOut, _ := os.Create("key.pem") 
pem.Encode(keyOut, &pem.Block(Type: "RSA PRIVATE KEY", Bytes: 
wx509.MarshalPKCS1PrivateKey(pk))) 


keyOut.Close() 
} 


生成 SSL 证 书 和 密 钥 的 步骤 并 不 是 特别 复杂 。 因 为 SSL 证 书 实际 上 
就 是 一 个 将 扩展 密 钥 用 法 (extended key usage) 设置 成 了 服务 器 身份 验 
证 操作 的 X.509 证 书 ， 所 以 程序 在 生成 证 书 时 使 用 了 crypto/x589 标准 
库 。 此 外 ， 因 为 创建 证 书 需要 用 到 私 铀 ， 所 以 程序 在 使 用 私 钥 成 功 创建 
证 书 之 后 ， 会 将 私 钥 单独 保存 在 一 个 存放 服务 器 私 钥 的 文件 里 面 。 








让 我 们 来 仔细 分 析 一 下 代码 清单 3-5 中 的 主要 代码 吧 。 首 先 ， 程 序 
使 用 一 个 Certificate 结构 来 对 证 书 进行 配置 : 


template := x509.Certificate( 
SerialNumber: serialNumber, 
Subject: subject, 
NotBefore: time.Now(), 
NotAfter: time.Now().Add(365*24*time.Hour), 


KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSignature, 
ExtKeyUsage: []x509.ExtKeyUsage(x509.ExtKeyUsageServerAuth), 
IPAddresses: []net.IP(net.ParseIP("127.0.0.1"))], 





结构 中 的 证 书 序列 号 (SerialNumber ) 用 于 记录 由 CA 分 发 的 唯 
一 号 但 ， 为 了 能 让 我 们 的 Web 应 用 运行 起 来 ， 程 序 在 这 里 生成 了 一 个 非 
党 长 的 随机 整数 来 作为 证 书 序列 号 。 之 后 ， 程 序 创建 了 一 个 专 有 名 称 
(distinguished name) ， 并 将 它 设置 成 了 证 书 的 标题 〈subject) 。 此 
外 ， 程 序 还 将 证 书 的 有 效 期 设置 成 了 一 年 ， 而 结构 中 KeyUsage 字段 和 
ExtKeyUsage 字段 的 值 则 表明 了 这 个 X.509 证 书 是 用 于 进行 服务 器 里 份 
验证 操作 的 。 最 后 ， 程 序 将 证 书 设置 成 了 只 能 在 IP 地 址 127.0.0.1 之 上 运 
^. 


X.509 是 国际 电信 联盟 电信 标准 化 部 门 〈ITU-T) 为 公 钥 基础 设施 制定 的 一 个 标准 ， 这 个 
标准 包含 了 公 钥 证 书 的 标准 格式 。 


















































一 个 X.509 证 书简 称 SSL 证 书 ) 实际 上 就 是 一 个 经 过 编码 的 ASN.1 (Abstract Syntax 
Notation One， 抽 象 语法 表示 法 /1) 格式 的 电子 文档 。ASN.1 既 是 一 个 标准 ， 也 是 一 种 表示 
法 ， 它 描述 了 表示 电信 以 及 计算 机 网 络 数据 的 规则 和 结构 。 









































X.509 证 书 可 以 使 用 多 种 格式 编码 ， 其 中 一 种 编码 格式 是 BER (Basic Encoding Rules， 基 
本 编码 规则 ) 。BER 格 式 指 定 了 一 种 自 解释 并 且 自 定义 的 格式 用 于 对 ASN.1 数 据 结构 进行 编 
码 ， 而 DER 格式 则 是 BER 的 一 个 子 集 。DER 只 提供 了 一 种 编码 ASN.1 值 的 方法 ， 这 种 方法 被 广 
泛 地 应 用 于 密码 学 当中 ， 尤 其 是 对 X.509 证 书 进行 加 密 。 



























































SSL 证 书 可 以 以 多 种 不 同 的 格式 保存 ， 其 中 一 种 是 PEM (Privacy Enhanced Email， 隐 私 增 
强 邮件 ) 格式 ， 这 种 格式 会 对 DER 格式 的 X.509 证 书 实施 Base64 编 码 ， 并 且 这 种 格式 的 文件 都 
B----- BEGIN CERTIFICATE----- 开头 ， 以 ----- END CERTIFICATE----- 结尾 (除了 用 
芷 文件 格式 之 外 ，PEM 和 此 处 讨论 的 SSL 证 书 关 系 并 不 大 ) 。 









































在 此 之 后 ， 程 序 通 过 调用 crypto/rsa 标准 库 中 的 GeneratekKey K 
数 生成 了 一 个 RSA 私 钥 : 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


JET Ge BSRSAASHBS Zi 4 SUI. T Be de ZU RES ZH 
(public key) ， 这 个 公 钥 在 使 用 x569 .CreateCertificate 函数 创建 
SSL 证 书 的 时 候 就 会 用 到 : 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, &template, 
w&pk.PublicKey, pk) 


CreateCertificate 函数 接受 Certificate 结构 、 公 和 钥 和 私 钥 等 





多 个 参数 ， 创 建 出 一 个 经 过 DER 编码 格式 化 的 字 节 切片 。 后 续 代 码 的 意 
图 也 非常 简单 明了 ， 它 们 首先 使 用 encoding/pem 标准 库 将 证 书 编码 
到 cert.pem 文件 里 面 : 


certOut, := Os.Create("cert.pem") 


pem.Encode(certOut, &pem.Block(Type: "CERTIFICATE", Bytes: derBytes}) 


certOut.Close() 








然后 继续 以 PEM 编 码 的 方式 把 之 前 生成 的 密 钥 编码 并 保存 到 
key .pem 文 件 里 面 : 


keyOut, _ := os.Create("key.pem") 
pem.Encode(keyOut, &pem.Block(Type: "RSA PRIVATE KEY", Bytes: 


wx509.MarshalPKCS1PrivateKey(pk))) 
keyOut .Close() 





最 后 需要 提醒 的 是 ， 如 果 证 书 是 由 CA 签发 的 ， 那 么 证 书 文件 中 将 
同时 包含 服务 器 签名 以 及 CA 签名 ， 其 中 服务 器 签名 在 前 ，CA 签 名 在 
后 。 


3.3 ”处 理 器 和 处 理 器 函数 





在 前 面 的 内 容 中 ， 我 们 启动 了 一 个 Web 服 务 器 ， 但 是 因为 这 个 服务 
器 尚未 实现 任何 功能 ， 所 以 现在 访问 这 个 服务 器 只 会 获得 一 个 404 
HTTP 响应 代码 。 出 现 这 一 问题 的 原因 在 于 我 们 尚未 为 服务 器 编写 任何 
处 理 器 ， 所 以 服务 器 的 多 路 复 用 器 在 接收 到 请 求 之 后 找 不 到 任何 处 理 器 
来 处 理 请 求 ， 因 此 它 只 能 返回 一 个 404 响 应 。 为 了 让 服务 器 能 够 产生 实 
际 的 行为 ， 我 们 需要 为 之 编写 处 理 器 。 


3.3.1 ”处 理 请 求 








前 面 的 第 1 章 和 第 2 章 曾 经 简单 地 介绍 过 处 理 器 以 及 处 理 器 函数 ， 现 
在 是 时 候 详 细 地 谈 谈 它 们 的 定义 了 。 在 Go 语言 中 ， 一 个 处 理 器 就 是 一 
个 拥有 ServeHTTP 方法 的 接口 ， 这 个 ServeHTTP 方法 需要 接受 两 个 参 
数 : 第 一 个 参数 是 一 个 ResponseWriter 接口 ， 而 第 二 个 参数 则 是 一 个 
指 癌 Request 结构 的 指针 。 换 句 话 说 ， 任 何 接 口 只 要 拥有 一 
个 ServeHTTP 方法 ， 并 且 该 方法 带 有 以 下 签名 (signature〉， 那 么 它 就 
是 一 个 处 理 器 : 


ServeHTTP(http.ResponseWriter, *http.Request) 


现在 ， 让 我 们 暂时 离 题 一 下 ， 回 答 一 个 在 阅读 本 章 时 可 能 会 出 现在 
你 脑海 里 面 的 问题 : 既然 ListenAndServe 接受 的 第 二 个 参数 是 一 个 处 
理 器 ， 那 么 为 何 它 的 默认 值 却 是 多 路 复 用 器 DefaultSserveMux WE? 





这 是 因为 DefaultServeMux 多 路 复 用 器 是 serveMux 结构 的 一 个 实 
例 ， 而 后 者 也 拥有 上 面 提 到 的 ServeHTTP 方法 ， 并 且 这 个 方法 的 签名 与 
成 为 处 理 器 所 需 的 签名 完全 一 致 。 换 名 话说 ，DefaultSserveMux BE 
是 ServeMux 结构 的 实例 ， 也 是 Handler 结构 的 实例 ， 
此 DefaultServeMux 不 仅 是 一 个 多 路 复 用 器 ， 它 还 是 一 个 处 理 器 。 不 
过 DefaultSserveMux 处 理 器 和 其 他 一 般 的 处 理 器 不 
I], DefaultServeMux 是 一 个 特殊 的 处 理 器 ， 它 唯一 要 做 的 就 是 根据 
请 求 的 URL 将 请 求 重 定向 到 不 同 的 处 理 器 。 在 了 解 了 这 些 知识 之 后 ， 我 
们 现在 只 需要 自行 编写 一 个 处 理 器 并 使 用 它 去 代替 默认 的 多 路 复 用 器 ， 
就 可 以 让 服务 器 正常 地 对 客户 端 进行 啊 应 了 ， 上 有 具体 如 代码 清单 3-6 所 





























3-6 ”处 理 请 求 





代码 清 














package main 


import ( 
"fmt" 
"net/http" 
) 


type MyHandler struct() 


func (h *MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello World!") 
j 


func main() { 
handler := MyHandler() 
server := http.Server( 
Addr: "127.0.0.1:8080", 
Handler: &handler, 
j 


server.ListenAndServe() 


} 








现在 ， 只 要 按照 2.7 市 介绍 过 的 方法 启动 服务 器 ， 并 使 用 浏览 器 访 
问 地 址 http:/Wlocalhost:8080/， 我 们 就 可 以 在 浏览 器 里 面 看 到 Hello World 
响应 了 。 


有 趣 的 是 ， 如 果 我 们 使 用 浏览 器 访问 
http://localhost:8080/anything/at/all， 同 样 会 看 到 相同 的 Hello Worldi 
应 。 造 成 这 个 问题 的 原因 非常 明显 : 在 代码 清单 3-6 中 ， 程 序 创建 了 一 
个 处 理 器 并 将 它 与 服务 器 进行 了 绑 定 ， 以 此 来 代 蔡 原本 正在 使 用 的 默认 
多 路 复 用 妖 。 这 意味 痢 服 务 器 不 会 再 通过 URL 匹 配 来 将 请 求 路 由 人 至 不 同 
的 处 理 器 ， 而 是 直接 使 用 同一 个 处 理 喜 来 处 理 所 有 请 求 ， 因 此 无 论 浏览 








器 访问 什么 地 址 ， 服 务 器 返回 的 都 是 同样 的 Hello World 响 应 。 


这 也 是 我 们 在 Web 应 用 中 使 用 多 路 复 用 器 的 原因 : 对 某 些 特殊 用 途 
的 服务 器 来 说 ， 只 使 用 一 个 处 理 器 也 许 就 可 以 很 好 地 完成 工作 了 ， 但 是 
在 大 部 分 情况 下 ， 我 们 还 是 希望 服务 器 可 以 根据 不 同 的 URL 请 求 返 回 不 
同 的 啊 应， 而 不 是 一 成 不 变 地 只 返回 一 种 啊 应 。 





3.3.2 ”使 用 多 个 处 理 器 


在 大 部 分 情况 下 ， 我 们 并 不 希望 像 代 码 清单 3-6 那 样 ， 使 用 一 个 处 
理 器 去 处 理 所 有 请 求 ， 而 是 希望 使 用 多 个 处 理 器 去 处 理 不 同 的 URL. 
为 了 做 到 这 一 点 ， 我 们 不 再 在 server 结构 的 Handler 字段 中 指定 处 理 

， 而 是 让 服务 器 使 用 默认 的 DefaultserveMux 作为 处 理 器 ， 然 后 通 
Handle 函数 将 处 理 器 绑 定 至 DefaultServeMux 。 需 要 注意 的 
是 ， ne 函数 来 源 于 http 包 ， 但 它 实 际 上 是 serveMux 结构 的 
方法 : 这 些 函 数 是 为 了 操作 便利 而 创建 的 函数 ， 调 用 它们 每 同 于 调 
ne 的 某 个 方法 。 比 如 说 ， 调 用 http .Handle 实际 上 
就 是 在 调用 DefaultServeMux 的 Handle 方法 。 


在 代码 清单 3-7 中 ， 程 序 创 建 了 两 个 处 理 器 ， 并 将 它们 与 各 自 的 
URL 进 行 了 绑 定 。 现 在 ， 访 问 地 址 http://localhost:8080/hello 将 会 看 
到 “Hello!*， 而 访问 地 http://localhost:8080/world 则 会 看 到 “World!”。 























代码 清单 3-7 使 用 多 个 处 理 器 对 请 求 进行 处 理 




















package main 


"net/http" 


) 


type HelloHandler struct() 
func (h *HelloHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 


fmt.Fprintf(w, "Hello!") 
I 


type WorldHandler struct() 


func (h *WorldHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 


{ 
fmt.Fprintf(w, "World!") 


} 
func main() { 
hello := HelloHandler() 
world := WorldHandler() 
server := http.Server( 
Addr: "127.0.0.1:8080", 
} 


http.Handle("/hello", &hello) 
http.Handle("/world", &world) 


server.ListenAndServe() 





3.3.3 “处理 器 函数 


上 一 小 节 对 处 理 器 进行 了 介绍 ， 那 么 什么 是 处 理 器 函数 呢 ? 处 理 器 
函数 实际 上 就 是 与 处 理 费 拥有 相同 行为 的 函数 ， 这 些 图 数 与 ServeHTTP 
方法 拥有 相同 的 签名 ， 也 就 是 说 ， 它 们 接受 ResponsewWriter 和 指 
向 Request 结构 的 指针 作为 参数 。 代 码 清单 3-8 展 示 了 如 何在 服务 器 中 
使 用 处 理 器 函数 。 























代码 清单 3-8 ”使 用 处 理 器 函数 处 理 请 求 
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package main 


import ( 
"fmt" 
"net/http" 


) 


func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 
j 


func world(w http.ResponseWriter, r *http.Request) { 


fmt.Fprintf(w, "World!") 
j 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
j 
http.HandleFunc("/hello", hello) 
http.HandleFunc("/world", world) 


server.ListenAndServe() 








处 理 器 函数 的 实现 原理 是 这 样 的 : Go 语言 拥有 一 种 HandlerFunc 
函数 类 型 ， 它 可 以 把 一 个 带 有 正确 签名 的 函数 f 转换 成 一 个 带 有 方法 ff 
的 Handler 。 比 如 说 ， 对 下 面 这 个 hello 函数 来 说 : 


func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 


} 








程序 只 需要 执行 以 下 代码 : 


helloHandler := HandlerFunc(hello) 


就 可 以 把 helloHandler 设置 成 一 个 Handler 。 如 果 你 对 此 感到 疑惑 ， 
那么 不 妨 回 顾 一 下 之 前 展示 过 的 接受 处 理 器 的 服务 嚣 代码: 


package main 


import ( 
"fmt" 
"net/http" 


j 
type HelloHandler struct{} 


func (h*HelloHandler) ServeHTTP(w thhp.ResponseWriter, r *http.Request)( 
fmt.Fprintf(w, "Hello! ") 


j 
type WorldHandler struct() 


func (h *WorldHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 
{ 


} 


fmt.Fprintf(w,"World!") 


func main 1 
hello := HelloHandler() 
world := WorldHandler() 


server :- thhp.Server( 
Addr: "127.0.0.1:8080", 


} 


http.Handle("/hello",&hello) 
http.Handle("/world",&world) 


server.ListenAndServe() 








这 个 程序 使 用 了 以 下 这 行 代码 来 绑 定 URL 地 址 /hello 和 hello r5 
数 : 


http.Handle("/hello", &hello) 


这 行 代码 向 我 们 展示 了 Handle 函数 将 一 个 处 理 器 绑 定 至 URL 的 具 
体 方法 。 此 外 ， 在 接受 处 理 器 函数 的 代码 清单 3-8 中 ，HandleFunc 函数 
会 将 hello 函数 转换 成 一 个 Handler ， 并 将 它 与 DefaultServeMux 进 
行 绑 定 ， 以 此 来 简化 创建 并 绑 定 Handler 的 工作 。 换 句 话 说 ， 处 理 器 函 
数 只 不 过 是 创建 处 理 器 的 一 种 便利 的 方法 而 已 。 代 码 清单 3-9 展 示 了 
http.HandleFunc 函数 的 具体 定义 。 





代码 清单 3-9 http.HandleFunc 函数 的 源 代码 





func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) ( 
DefaultServeMux.HandleFunc(pattern, handler) 


} 





而 下 面 是 ServeMux.HandleFunc 方法 的 定义 : 


func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWrite 
n, 
*Request)) ( 


mux.Handle(pattern, HandlerFunc(handler)) 
j 





注意 这 个 方法 是 如 何 使 用 HandlerFunc 函数 将 传 入 的 handler K 
数 转换 成 真正 的 处 理 器 的 。 


里 然 处 理 器 函数 能 够 完成 跟 处 理 絮 一 样 的 工作 ， 并 且 使 用 处 理 占 函 
数 的 代码 比 使 用 处 理 器 的 代码 更 为 整洁 ， 但 是 处 理 需 图 数 并 不 能 完全 代 
答 处 理 器 。 这 和 古 因 为 在 茶 些 情况 下 ， 代 码 可 能 已 经 包含 了 茶 个 接口 或 者 
某 种 类 型 ， 这 时 我 们 只 需要 为 它们 添加 ServeHTTP 方法 就 可 以 将 它们 转 
变 为 处 理 器 了 ， 并 且 这 种 转变 也 有 助 于 构建 出 更 为 模块 化 的 web 应 用 。 


3.3.4 串联 多 个 处 理 器 和 处 理 器 函数 


尽管 Go 语言 并 不 是 一 门 函 数 式 编程 语言 ， 但 它 也 拥有 一 些 函 数 式 
E R TE 如 函数 类 型 、 匿 名 函数 和 闭 包 。 PLE 
， 在 Go 语言 里 面 ， 程 序 可 以 将 一 个 函数 传递 给 为 一 个 函数 ， 叉 或 者 
Ru AS 数 。 这 意味 着 ， m 
那样 ， 将 函数 fl 传递 给 另 一 个 函数 f2 ， 然 后 在 函数 f2 执行 完 某 些 操 作 


之 后 调用 f1 。 
执行 指定 的 操作 





输入 


f1 


输出 
执行 指定 的 操作 


图 3-3 ”串联 起 多 个 处 理 器 





来 看 一 个 完整 的 例子 : 假设 我 们 想 要 在 每 个 处 理 器 被 调用 时 ， 在 茶 
个 地 方 记 录 下 相应 的 调用 信息 。 为 此 ， 我 们 可 以 在 处 理 费 里 面 添加 一 些 
颌 外 的 代码 ， 又 或 者 像 第 2 章 那 样 ， 将 这 些 记录 代码 重 构 成 一 个 工具 函 
数 ， 然 后 让 每 个 处 理 圳 都 去 调用 这 个 工具 函数 。 虽 然 实 现 上 面 提 到 的 两 
种 方法 并 不 困难 ， 但 引入 额外 代码 的 做 法 会 给 程序 的 编写 带 来 及 烦 ， 并 
导致 处 理 需 需要 包含 与 处 理 请 求 无 天 的 代码 。 


诸如 日 志 记 录 、 安 全 检查 和 错误 处 理 这 样 的 操作 通常 被 称 为 横 切 关 
注 点 Ccross-cutting concen) ， 昌 然 这 些 操 作 非 常常 见 ， 但 是 为 了 防止 
代码 重复 和 代码 依赖 问题 ， 我 们 又 不 希望 这 些 操 作 和 正常 的 代码 搅和 在 
一 起 。 为 此 ， 我 们 可 以 使 用 串联 (chaining) 技术 分 隔 代码 中 的 横 切 关 
注 点 。 代 码 清单 3-10 展 示 了 一 个 串联 多 个 处 理 器 的 例子 。 

















代码 清单 3-10 ”串联 两 个 处 理 器 函数 











package main 


import ( 
"fmt" 
"net/http" 
"reflect" 
"runtime" 


) 


func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 
} 


func log(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.ResponseWriter, r *http.Request) { 
name := runtime.FuncForPC(reflect.ValueOf(h).Pointer()).Name() 
fmt.Println("Handler function called - " + name) 
h(w, r) 
} 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/hello", log(hello)) 
server.ListenAndServe() 





除 处 理 器 函数 hello 之 外 ， 这 个 代码 清单 还 包含 了 一 个 log R 
Zt. log 函数 接受 一 个 HandlerFunc 类 型 的 函数 作为 参数 ， 然 后 返回 另 


一 个 HandlerFunc 类 型 的 函数 作为 值 。 因 为 hello 函数 就 是 一 

个 HandlerFunc 类 型 的 函数 ， 所 以 代码 log(hello) 实际 上 就 是 

将 hello 函数 发 送 至 1og 函数 之 内 ， 换 句 话 说， 这 段 代 码 串 联 起 了 1og 
函数 和 hello 函数 。 


log 函数 的 返回 值 是 一 个 匿名 函数 ， 因 为 这 个 匿名 函数 接受 一 
个 ResponseWriter 和 一 个 Request 指针 作为 参数 ， 所 以 它 实际 上 也 是 
一 个 HandlerFunc 。 在 匿名 函数 内 部 ， 程 序 首 先 会 获取 被 传 入 的 
HandlerFunc 的 名 字 ， 然 后 再 调用 这 个 HandlerFunc 。 作 为 结果 ， 如 
果 我 们 使 用 浏览 器 访问 地 址 http://localhost:8080/hello， 那 么 浏览 器 页 面 
将 显示 以 下 信息 : 


Handler function called - main.hello 


就 像 搭 积木 一 样 ， 既 然 我 们 可 以 串联 起 两 个 函数 ， 那 么 自然 也 可 以 
串联 起 更 多 函数 。 串 联 多 个 函数 可 以 让 程序 执行 更 多 动作 ， 这 种 做 法 有 
时 候 也 称 为 管道 处 理 (pipeline processing) ， 如 图 3-4 所 示 。 











输入 


执行 指定 的 操作 





执行 指定 的 操作 


f1 


输出 
执行 指定 的 操作 


举 个 例子 ， 如 果 我 们 还 有 一 个 protect 函数 ， 它 会 在 调用 传 入 的 处 
理 占 之 前 验证 用 户 的 身份 : 




















图 3-4 ”串联 更 多 处 理 器 





func protect(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.ResponseWriter, r *http.Request) { 


e.. 8 
h(w, r) 





@ 7f eed. KEAR T BATRA Xo EARE 


那么 我 们 只 需要 把 protect 函数 跟 之 前 的 函数 串联 在 一 起 ， 就 可 以 正常 
使 用 这 个 函数 了 : 


http.HandleFunc("/hello", protect(log(hello))) 


你 可 能 已 经 注意 到 了 ， 虽 然 我 们 一 直 讨 论 的 都 是 如 何 串联 处 理 器 ， 


但 代码 清单 3-10 实 际 上 却 是 在 串联 处 理 絮 阔 数 。 不 过 正如 代码 清单 3-11 
所 示 ， 串 联 处 理 器 的 方法 实际 上 和 串联 处 理 器 函数 的 方法 是 非常 相似 
的 。 


























代码 清单 3-11 串联 多 个 处 理 器 














package main 


"net/http" 
) 


type HelloHandler struct() 


func (h HelloHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) ( 
fmt.Fprintf(w, "Hello!") 


} 


func log(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.ResponseWriter, r *http.Request) 


{ 
fmt.Printf("Handler called - %T\n", h) 


h.ServeHTTP (w, r) 
}) 
} 


func protect(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.ResponseWriter, r *http.Request) 
{ 
e wo 9 
h.ServeHTTP (w, r) 
}) 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
hello := HelloHandler{} 
http.Handle("/hello", protect(log(hello))) 
server.ListenAndServe() 





@ 为 了 布 省 篇 幅 ， 这 里 省 略 了 一 段 用 于 检测 用 户 登 录 情 况 的 代码 








让 我 们 来 观察 一 下 代码 清单 3-11 和 代码 清单 3-10 有 什么 区 别 。 代 码 
清单 3-11 中 的 Hello Handler 在 前 面 的 代码 清单 中 己 经 展示 过 ， 它 跟 
代码 清单 3-10 中 的 hello 函数 一 样 ， 都 位 于 串联 链 的 末尾 。 
数 则 不 再 接受 和 返回 HandlerFunc 类 型 的 函数 ， 而 是 接受 并 返 
Handler 类 型 的 处 理 器 : 


func log(h http.Handler) http.Handler { 


return http.HandlerFunc (func(w http.ResponseWriter, r *http.Request) 
{ 
fmt.Printf("Handler called - %T\n", h) 
h.ServeHTTP (w, r) 
}) 
} 








log 函数 和 protect 函数 现在 不 再 返回 匿名 函数 ， 而 是 使 
用 HandlerFunc 直接 将 匿名 函数 转换 成 一 个 Handler ， 然 后 返回 这 
个 Handler 。 程 序 现在 也 不 再 直接 执行 处 理 器 函数 了 ， 而 是 调用 处 理 器 
的 ServeHTTP 函数 。 最 后 的 一 点 变化 是 ， 程 序 现在 绑 定 的 是 处 理 器 而 不 
Je AE EE SR ER: 











hello := HelloHandler() 
http.Handle("/hello", protect(log(hello))) 


除了 以 上 提 到 的 区 别 之 外 ， 两 个 程序 的 其 余 代码 基本 上 都 是 相同 
的 。 


串联 处 理 恬 和 处 理 器 函数 是 一 种 非常 币 见 的 惯用 法 ， 很 多 Web 应 用 
框架 都 使 用 了 这 一 技术 。 


3.3.5 ServeMux 和 DefaultServeMux 


本 章 和 前 一 章 都 对 ServeMux 和 DefaultServeMux 进行 了 介 
绍 。ServeMux 是 一 个 HTTP 请 求 多 路 复 用 器 ， 它 负责 接收 HTTP 请 求 并 
根据 请 求 中 的 URL 将 请 求 重 定 同 到 正确 的 处 理 器 ， 如 图 3-5 所 示 。 
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/hello 





多 路 复 用 器 : 


ServeMux 





/world 





J ao 


一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


图 3-5 ”通过 多 路 复 用 器 将 请 求 转发 给 各 个 处 理 器 








ServeMux 结构 包含 了 一 个 上 映射， 这 个 映射 会 将 URL 映 射 至 相应 的 
处 理 器 。 正 如 之 前 所 说 ， 因 为 ServeMux 结构 也 实现 了 ServeHTTP 7; 
法 ， 所 以 它 也 是 一 个 处 理 器 。 当 ServeMux 的 ServeHTTP 方法 接收 到 一 
个 请 求 的 时 候 ， 它 会 在 结构 的 映射 里 面 找 出 与 被 请 求 URL 最 为 匹配 的 
URL， 然 后 调用 与 之 相对 应 的 处 理 器 的 ServeHTTP 方法 ， 如 图 3-6 所 
示 。 
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indexHandler 
请 求 
/hello helloHandler helloHandler 
GET /hello HTTP/1.1 
worldHandler 
worldHandler 


这 个 结构 负责 将 URL ServeMux 结 构 的 ServeHTTP 
映射 至 处 理 器 。 方法 会 调用 URL 对 应 的 处 理 器 
的 ServeHTTP 方 法 。 
































图 3-6 ”多 路 复 用 器 的 工作 原理 











在 介绍 完 ServeMux 之 后 ， 让 我 们 来 了 解 一 下 DefaultServeMux 。 
因为 ServeMux 是 一 个 结构 而 不 是 一 个 接口 ， 所 以 DefaultServeMux 并 
不 是 ServeMux 的 实现 。Default-ServeMux 实际 上 是 ServeMux 的 一 
个 实例 ， 并 且 所 有 引入 了 net/http 标准 库 的 程序 都 可 以 使 用 这 个 实 
例 。 当 用 户 没 有 为 Server 结构 指定 处 理 占 时 ， 服 务 占 就 会 使 
用 DefaultServeMux 作为 ServeMux 的 默认 实例 。 


此 外 ， 因 为 ServeMux 也 是 一 个 处 理 嚣 ， 所 以 用 户 也 可 以 在 有 需要 
的 情况 下 对 其 实例 实施 处 理 器 串联 。 





在 上 面 的 几 个 例子 中 ， 被 请 求 的 URL /hello 完美 地 匹配 了 与 多 路 
复 用 器 绑 定 的 URL， 但 如 果 浏 览 器 访问 的 是 /random 或 
者 /hello/there ， 那 么 服务 器 又 会 返回 什么 啊 应 呢 ? 


这 个 问题 的 答案 跟 我 们 绑 定 UREL 的 方法 有 关 : 如 果 我 们 像 图 3-6 那 
样 绑 定 根 URL C/O ， 那 么 匹配 不 成 功 的 URL 将 会 根据 URL 的 层级 进行 


下 降 ， 并 最 终 降落 在 根 URL 之 上 。 当 浏览 器 访问 /random 的 时 候 ， 因 为 
服务 器 无 法 找到 负责 处 理 这 个 URL 的 处 理 器 ， 所 以 它 会 把 这 个 URL 交 给 
根 URL 的 处 理 器 处 理 ( 对 于 图 中 所 示 的 例子 来 襄 ， 束 是 使 

用 indexHandler 来 处 理 这 个 URL ) 。 





那么 服务 器 又 是 如 何 处 理 /hello/there 的 呢 ? 根据 最 小 惊讶 原则 
(The Principle of Least Surprise) ， 因 为 程序 已 经 为 /hello 绑 定 了 处 理 
器 ， 所 以 在 默认 情况 下 ， 程 序 似乎 应 该 使 用 helloHandler 处 
理 /hello/there 。 但 是 对 图 3-6 所 示 的 例子 来 说 ， 服 务 器 实际 上 会 使 
用 indexHandler 去 处 理 对 /hello/there 的 请 求 。 





最 小 惊讶 原则 























最 小 惊讶 原则 ， 也 称 最 小 意外 原则 ， 是 设计 包括 软件 在 内 的 一 切 事物 的 一 条 通用 规则 ， 
它 指 的 是 我 们 在 进行 设计 的 时 候 ， 应 该 做 那些 合乎 常理 的 事情 ， 使 事物 的 行为 总 是 显 而 易 
见 、 始 终 如 一 并 且 合乎 情理 。 





















































举 个 例子 ， 如 果 我 们 在 一 扇 门 的 劳 边 放 置 一 个 按钮 ， 那 么 人 们 就 会 认为 这 个 按钮 与 这 局 
门 有 关 ， 比 如 ， 按 下 按钮 门铃 会 啊 或 者 门 会 自动 打开 ， 等 等 。 但 是 ， 如 果 这 个 按钮 被 按 下 时 
会 关 掉 走 请 的 灯光 ， 它 就 违反 了 最 小 尺 诈 原则 ， 因 为 这 一 行为 不 符合 人 们 对 这 个 按钮 的 预 
期 。 





























产生 这 种 行为 的 原因 在 于 程序 在 绑 定 helloHandler 时 使 用 的 URL 
是 /hello 而 不 是 /hello/ 。 如 果 和 被 绑 定 的 URL 不 是 以 / 结尾 ， 那 么 它 
只 会 与 完全 相同 的 URL 匹 配 ; 但 如 果 被 绑 定 的 URL 以 / 结尾 ， 那 么 即使 
请 求 的 URL 只 有 前 级 部 分 与 被 绑 定 URL 相 同 ，ServeMux 也 会 认定 这 两 
个 URL 是 匹配 的 。 





这 也 就 是 说 ， 如 果 与 helloHandler 处 理 器 绑 定 的 URL 是 /hello/ 
而 不 是 /hello ， 那 么 当 浏 览 器 请 求 /hello/there 的 时 候 ， 服 务 器 在 
找 不 到 与 之 完全 匹配 的 处 理 器 时 ， 就 会 退 而 求 其 次 ， 开 始 寻 找 能 够 
与 /hello/ 匹配 的 处 理 器 ， 并 最 终 找 到 helloHandler 处 理 器 。 








3.3.6 ”使 用 其 他 多 路 复 用 顺 


因为 创建 一 个 处 理 器 和 多 路 复 用 器 唯一 需要 做 的 就 是 实现 
ServeHTTP 方法 ， 所 以 通过 自行 创建 多 路 复 用 器 来 代替 net/http 包 中 
的 ServeMux 是 完全 可 行 的 ， 并 且 目 前 市 面 上 已 经 出 现 了 很 多 第 三 方 的 
多 路 复 用 器 可 供 使 用 ， 比 如 ，Gorilla Toolkit (www.gorillatoolkit.org) 
就 是 一 个 非常 优秀 的 第 三 方 多 路 复 用 器 包 ， 它 提供 了 mux Mpat 这 两 个 
工作 方式 非常 不 同 的 多 路 复 用 器 ， 而 本 节 将 要 介绍 的 则 是 另 一 个 高 效 的 
轻 量 级 第 三 方 多 路 复 用 器 一 一 HttpRouter。 








ServeMux 的 一 个 缺陷 是 无 法 使 用 变量 实现 URL 模 式 匹配 。 虽 然 在 
浏览 器 请 求 /threads 的 时 候 ， 使 用 ServeMux 可 以 很 好 地 获取 并 显示 
论坛 中 的 所 有 帖子 ， 但 如 果 浏 览 器 请 求 的 是 /thread/123 ， 那 么 要 获 
取 并 显示 论坛 里 面 卫 为 123 的 帖子 就 会 变 得 非常 困难 。 程 序 必 须 对 URL 
进行 语法 分 析 才 能 提取 出 URL 当 中 的 帖子 ID。 此 外 ， 因 为 受 ServeMux 
实现 URL 模 式 匹 配 的 方式 所 限 ， 如 采 我 们 想 要 通 
过 /thread/123/post/456 这 样 的 URL 从 ID 为 123 的 帖子 中 获取 ID 为 
456 的 回复 ， 就 必须 在 程序 里 面 进行 大 量 复 杂 的 语法 分 析 ， 并 因此 给 程 
序 带 来 额外 的 复杂 度 。 











与 ServeMux 不 同 ，HttpRouter 包 并 没有 上 面 提 到 的 这 些 限 制 。 


本 节 将 对 HttpRouter 包 最 重要 的 一 部 分 特性 进行 ， 关 于 这 个 包 的 
更 详细 的 说 明 可 以 在 它 的 文档 页 面 里 面 看 到 : 
https://github.com/julienschmidt/httprouter。 代 码 清 单 3-12 展 示 了 一 个 使 用 
HttpRouter 实 现 的 服务 器 。 











代码 清单 3-12 ”使 用 HttpRouter 实 现 的 服务 器 

















package main 


import ( 
"fmt" 
"github.com/julienschmidt/httprouter" 
"net/http" 

) 


func hello(w http.ResponseWriter, r *http.Request, p httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name")) 


} 


func main() { 
mux := httprouter.New() 
mux.GET("/hello/:name", hello) 


server := http.Server( 
Addr: "127.0.0.1:8080", 
Handler: mux, 


} 


server.ListenAndServe() 





这 个 程序 中 的 大 部 分 代码 都 和 之 前 展示 过 的 代码 一 样 ， 只 是 涉 
路 复 用 器 的 部 分 代码 跟 之 前 有 所 不 同 。 在 这 段 代 码 里 ， 程 序 通过 调 
用 New 函数 来 创建 一 个 多 路 复 用 器 : 


mux := httprouter.New() 


这 个 程序 不 再 使 用 HandleFunc 绑 定 处 理 器 测 数 ， 而 是 直接 把 处 理 
器 函数 与 给 定 的 HITTP 方 法 进行 绑 定 : 


mux.GET("/hello/:name", hello) 


这 段 代 码 会 把 给 定 URL 的 GET 方法 与 hello 处 理 器 函数 进行 绑 定 ， 
当 浏 览 器 向 这 个 URL 发 送 6ET 请 求 时 ，hello 函数 就 会 被 调用 ， 但 如 果 
浏览 器 向 这 个 URL 发 送 除 GET 请 求 之 外 的 其 他 请 求 ，hello 函数 则 不 会 
被 调用 。 ne e 被 绑 定 的 URL 包 含 了 具名 参数 (named 
parameter) ， 这 些 具 名 参数 会 被 URL 中 的 具体 值 所 代替 ， 并 且 程 序 可 以 
在 处 理 器 里 面 获取 这 些 值 。 





跟 之 前 的 处 理 器 函数 相 比 ， 现 在 的 hello 处 理 器 函数 也 发 生 了 变 
化 ， 它 不 再 接受 两 个 参数 ， 而 是 接受 3 个 参数 。 其 中 odi dos 
就 包含 了 之 前 提 到 的 具名 参数 ， 有 具名 参数 的 值 可 以 在 处 理 器 内 部 通 
ByName 方法 获取 : 





func hello(w http.ResponseWriter, r *http.Request, p httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name")) 





程序 的 最 后 一 个 变化 是 它 不 再 使 用 默认 的 DefaultServeMux ， 而 
是 通过 将 HttpRouter 传 递 给 Server 结构 来 使 用 这 个 多 路 复 用 髓 : 
server := http.Server( 


Addr: "127.0.0.1:8080", 
Handler: mux, 


} 


server.ListenAndServe() 





现在 ， 如 果 我 们 在 终端 上 执行 go build 命令 ， 那 么 编译 器 将 返回 


一 个 错误 : 


$ go build 
server.go:5:5: cannot find package "github.com/julienschmidt/httprouter" i 
n 

any of: 


/usr/local/go/src/github.com/julienschmidt/httprouter (from $GOROOT) 
/Users/sausheong/gws/src/github.com/julienschmidt/httprouter (from $GO 
PATH) 








出 现 这 个 错误 的 原因 在 于 ， 我 们 虽然 指定 了 HttpRoter 库 ， 但 这 个 第 
三 方 库 在 我 们 的 电脑 上 并 不 存在 ， 得 益 于 Go 语言 强大 且 易 用 的 包 管 理 
系统 ， 我 们 只 需要 执行 以 下 命令 就 可 以 解决 这 个 问题 了 : 


$ go get github.com/julienschmidt/httprouter 


在 电脑 连接 了 网 络 的 情况 下 ， 这 个 命令 会 从 HttpRouter 的 GitHub 主 
页 上 下 载 HttpRouter 包 的 源 代码 ， 并 将 其 存储 到 $GOPATH/src 目录 中 。 
在 此 之 后 ， 当 我 们 再 次 执行 go_ build 命令 尝试 编译 代码 清单 3-12 所 示 
的 服务 器 时 ， 编 译 器 就 会 导入 HttpRouter 的 代码 ， 并 对 整个 服务 器 进行 
编译 。 








3.4 使 用 HTTP/2 


在 本 章 的 最 后 ， 让 我 们 来 了 解 一 下 如 何 使 用 HTTP/2 构 建 本 章 介 绍 
的 Web 服 务 器 。 


本 书 在 第 1 章 已 经 对 HTTP/2 做 过 简单 的 介绍 ， 并 且 提 到 过 在 1.6 或 以 


上 版 本 的 Go 语言 中 ， 如 果 使 用 HTTPS 模 式 启 动 服务 器 ， 那 么 服务 器 将 
默认 使 用 HTTP/2。 但 是 ， 在 默认 情况 下 ， 版 本 低 于 1.6 版 本 的 Go 语言 
不 会 安装 http2 包 ， 因 此 用 户 需 要 通过 手动 执行 以 下 命令 来 获取 这 

包 : 


go get "golang.org/x/net/http2" 


为 了 让 代码 清单 3-6 中 构建 的 web 服务 器 用 上 HTTP/2， 我 们 需要 给 
这 个 服务 器 导入 http2 包 ， 并 通过 添加 一 些 代码 行 来 让 服务 器 打开 对 
HTTP/2 的 支持 。 为 了 做 到 这 一 点 ， 我 们 需要 调用 http2 包 中 的 
ConfigureServer 方法 ， 并 将 服务 器 配置 传递 给 它 ， 修 改 后 的 服务 器 
代码 如 代码 清单 3-13 所 示 。 





代码 清单 3-13 ”启用 HTTP/2 





package main 


import ( 
"fmt" 
"golang.org/x/net/http2" 
"net/http" 

) 


type MyHandler struct() 


func (h *MyHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello World!") 


} 


func main() { 
handler := MyHandler() 
server := http.Server( 
Addr: "127.0.0.1:8080", 
Handler: &handler, 


} 
http2.ConfigureServer(&server, &http2.Server{}) 


server.ListenAndServeTLS("cert.pem", "key.pem") 


} 








现在 ， 我 们 只 要 执行 以 下 代码 束 可 以 局 动 这 个 打开 了 HTTP/2 功 能 
的 Web 服 务 器 了 : 


go run server.go 


为 了 检查 服务 器 是 否 运 行 在 HTTP/2 模 式 之 下 ， 我 们 可 以 使 用 cURL 
对 服务 器 进行 检查 。 因 为 cURL 在 很 多 平台 上 都 是 可 用 的 ， 所 以 本 书 会 





经 第 使 用 它 作 为 检测 工具 ， 因 此 现在 是 时 候 来 学 习 一 下 如 何 使 用 cURL 
Tf. 







cURL 是 一 个 命令 行 工具 ， 它 可 以 获取 指定 URL 上 的 文件 ， 又 或 者 向 指定 的 URL 发 送 文 
件 。cURL 支 持 数 量 庞 大 的 常用 互联 网 协议 ， 其 中 就 包括 HTTP 和 HTTPS。cURL 默 认 安 装 在 包 
括 OS X 在 内 的 很 多 Unix 变 种 之 上 ， 并 且 它 同样 可 以 在 Windows 系 统 上 使 用 。 手 动 下 载 和 安装 
cURL 的 方法 可 以 通过 页 面 http://curl.haxx.se/download.html 看 到 |。 



































cURL 从 7.43.0 版 本 开始 支持 HTTP/2， 用 户 在 发 送 请 求 的 时 候 ， 只 
需要 打开 --http2 标志 (flag) 就 可 以 发 送 HTTP/2 请 求 了 。 此 外 ， 为 了 
让 cURL 能 够 支持 HTTP/2， 用 户 还 必须 将 cURL 与 nghttp2 这 个 提供 





HTTP/2 支 持 的 C 语 言 库 进行 链接 Cink) 。 在 撰写 本 节 的 时 候 ， 包 括 OS 
X 平 台 在 内 的 很 多 默认 的 cCURL 实 现 都 还 没有 提供 对 HITP/2 的 文 持 ， 
此 我 们 可 能 需要 重新 编译 cURL， 将 它 与 nghttp2 库 进 行 链 接 ， 然 后 用 
编译 后 的 新 版 cURL 代 蔡 原 有 的 CURL。 


在 完成 重新 编译 cURL 的 工作 之 后 ， 我 们 可 以 使 用 以 下 命令 去 检查 
代码 清单 3-13 展 示 的 Web 应 用 是 否 启 用 了 HTTP/2: 


curl -I --http2 --insecure https://localhost:8080/ 


在 默认 情况 下 ，cURL 在 以 HTTP/2 形 式 访问 一 个 Web 应 用 的 时 候 ， 
会 对 应 用 的 证 书 进行 验证 ， 并 在 验证 无 法 通过 时 拒绝 访问 。 因 为 我 们 的 
Web 应 用 使 用 的 是 自行 创建 的 证 书 和 密 铀 ， 它 们 默认 是 无 法 通过 这 一 验 
证 的 ， 所 以 上 面 的 命令 在 调用 cURL 的 时 候 使 用 了 insecure 标志 ， 这 个 
标志 会 让 cURL 强制 接受 我 们 创建 的 证 书 ， 从 而 使 访问 可 以 顺利 进行 。 


如 果 一 切 顺利 ，cURL 将 返回 以 下 输出 : 


HTTP/2.0 200 
content-type:text/plain; charset-utf-8 


content-length:12 
date:Mon, 15 Feb 2016 05:33:01 GMT 





本 章 虽 然 详 细 介 绍 了 如 何 接收 HTTP 请 求 ， 但 是 并 没有 有 具体 地 说 明 
如 何 处 理 接收 到 的 请 求 ， 以 及 如 何 向 客户 端 返 回 啊 应。 虽然 处 理 器 和 处 
理 器 函数 是 使 用 Go 编写 Web 应 用 的 关键 ， 但 如 何 处 理 请 求 以 及 如 何 发 送 
响应 才 是 web 应 用 真正 安 喘 立 命 之 所 在 。 在 接 下 来 的 一 章 中 ， 我 们 将 深 
入 学 习 请 求 和 啊 应 的 细节 ， 了 解 如 何 从 请 求 中 提取 信息 ， 以 及 如 何 通过 
响应 传递 信息 。 











3.5 Z2 


。 Go 语言 拥有 一 系列 成 熟 的 标准 库 ， 如 net/http 和 htm1/templat« 


， 这 些 标 准 库 可 以 用 于 构建 Web 应 用 。 

尽管 使 用 web 框架 可 以 更 容易 并 且 更 快捷 地 构建 Web 应 用 ， 但 是 在 
使 用 这 些 框架 之 前 ， 先 了 解 Web 编 程 所 需 的 基础 知识 也 是 非常 重要 
的 。 
Go 语言 的 net/http 标准 库 可 以 将 HITP 通 信 放 到 SSL 之 上 进行 ， 也 
就 是 通过 HTTPS 方 式 创 建 出 更 为 安全 的 通信 连接 。 
Go 语言 的 处 理 嚣 可 以 是 任何 市 有 ServeHTTP 方法 的 结构 ， 其 中 
ServeHTTP 方法 需要 接收 两 个 参数 : 第 一 个 参数 是 一 个 
ResponseWriter 接口 ， 而 第 二 个 参数 则 是 一 个 指向 Request 结构 
的 指针 。 
处 理 器 函数 是 与 处 理 器 拥有 相似 行为 的 函数 。 处 理 器 函数 用 于 处 理 
请 求 ， 它 们 跟 ServeHTTP 方法 拥有 相同 的 签名 。 
通过 串联 处 理 器 或 者 处 理 器 函数 ， 可 以 对 程序 中 的 横 切 关注 点 进行 
分 隔 ， 并 以 模块 化 的 方式 处 理 请 求 。 
多 路 复 用 器 也 是 处 理 器 。 比 如 ， ServeMux 就 是 一 个 HTTP 请 求 多 路 
复 用 器 ， 它 接受 HTTP 请 求 并 根据 请 求 中 的 URL 将 请 求 重 定 问 到 正 
确 的 处 理 器 。 DefaultServeMux 是 ServeMux 的 一 个 公开 的 实例 ， 
这 个 实例 会 被 用 作 默 认 的 多 路 复 用 器 。 
在 Go 1.6 或 以 上 的 版 本 中 ， net/http 标准 库 默 认 支 持 HTTP/2。 版 
本 低 于 1.6 的 Go 语言 如 果 想 要 获得 HTTP/2 文 持 ， 就 需要 手动 添加 
http2 包 。 














第 4 章 ”处 理 请 求 


本 章 主要 内 容 


。 使 用 Go 发 送 请 求 和 响应 

。 使 用 Go 处 理 HTML 表 单 

e 使 用 ResponseWritern 向 客户 端 回 传 响应 
e 使 用 cookie 存 储 信息 

e 使 用 cookie 实 现 闪 现 消 息 


在 前 一 章 ， 我 们 学 习 了 如 何 使 用 Go 语言 内 置 的 net/Vhttp EAE 
Web 应 用 服务 器 ， 并 厌 此 了 解 了 处 理 器 、 处 理 器 函数 以 及 多 路 复 用 器 。 
在 学 会 了 如 何 接收 请 求 并 将 请 求 转发 给 相应 的 处 理 器 之 后 ， 本 章 我 们 要 
学 习 的 是 如 何 使 用 Go 提供 的 工具 来 处 理 请 求 ， 以 及 如 何 把 啊 应 回 传 给 
客户 端 。 


44 ”请求 和 啊 应 


本 书 的 第 1 革 对 HTTP 报 文 做 了 不 少 介绍 ， 为 了 加 深 印 象 、 防 止 遗 
态 ， 让 我 们 先 来 回顾 一 下 这 方面 的 知识 。HTTP 报 文 是 在 客户 端 和 服务 
虱 之 间 传 递 的 消 旦 ， 它 分 为 HTTP 请 求 和 HTTP 啊 应 两 种 类 型 ， 并 且 这 两 
种 类 型 的 报 文部 拥有 相同 的 结构 : 





(1) 请 求 行 或 者 啊 应 行 ; 


(2) 零 个 或 多 个 首部 ; 
(3) 一 个 空 行 ; 


一 个 可 选 的 报 文 主体 。 


NA 


(4 
下 面 是 一 个 GET 请 求 的 例子 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 


User-Agent: Mozilla/5.0 
(empty line) 





Go 语言 的 net/http 库 提供 了 一 系列 用 于 表示 HTTP 报 文 的 结构 ， 
为 了 学 习 如 何 使 用 这 个 库 处 理 请 求 和 发 送 响应 ， 我 们 必须 对 这 些 结构 有 
所 了 解 。 首 先 ， 让 我 们 来 看 看 net/http 库 中 代表 HTTP 请 求 报 文 的 
Request 结构 。 


4.1.1 ” Request 结构 


Request 结构 表示 一 个 由 客户 端 发 送 的 HTTP 请 求 报 文 。 虽然 HTTP 
请 求 报 文 是 由 一 系列 文本 行 组 成 的 ， 但 Request 结构 并 不 是 完全 按照 报 
文 逐 字 逐 名 定义 的 。 实 际 情况 是 ， 这 个 结构 只 包含 了 报 文 在 经 过 语法 分 
析 之 后 ， 其 中 较为 重要 的 信息 ; 除 此 之 外 ， 这 个 结构 还 有 一 系列 相应 的 
方法 可 供 使 用 。 





Request 结构 主要 由 以 下 部 分 组 成 : 


e URL 字段 ; 
e Header ^E Et; 


。 Body 字段 ; 
e Form 字段 、 PostForm 字段 和 MultipartForm 字段 。 





通过 Request 结构 的 方法 ， 用 户 还 可 以 对 请 求 报 文中 的 cookie、 引 
用 URL 以 及 用 户 代理 进行 访问 。 当 net/http 库 被 用 作 HTTP 客 户 端的 时 
候 ，Request 结构 既 可 以 用 于 表示 客户 并 将 要 发 送 给 服务 器 的 请 求 ， 也 
可 以 用 于 表示 服务 器 接收 到 的 客户 端 请 求 。 





4.1.2 请求 URL 

Request 结构 中 的 URL 字段 用 于 表示 请 求 行 中 包含 的 URL 请求 行 
也 就 是 HTTP 请 求 报 文 的 第 一 行 ) ， 这 个 字段 是 一 个 指向 url.URL 结构 
的 指针 ， 代 码 清单 4-1 展 示 了 这 个 结构 的 定义 。 





代码 清单 41 URL 结构 





type URL struct { 
Scheme string 
Opaque string 
User *Userinfo 
Host string 


Path string 
RawQuery string 
Fragment string 





URE 的 一 般 格 式 为 : 


scheme://[userinfo@]host/path[ ?query |[#fragment] 


那些 在 scheme 之 后 不 带 斜 线 的 URE 则 会 被 解释 为 : 


scheme:opaque[ ?query][#fragment ] 


在 开发 Web 应 用 的 时 候 ， 我 们 第 常会 让 客户 端 通过 URL 的 得 询 参数 
向 服务 器 传递 信息 ， 而 URL 结 构 的 RawQuery 字段 记录 的 就 是 客户 端 向 
服务 器 传递 的 查询 参数 字符 串 。 举 个 例子 ， 如 果 客 户 端 向 地 
TiEhttp://www.example.com/post?id2123&thread id-456 发 送 一 个 请 求 ， 
那么 RawQuery 字段 的 值 束 会 被 设置 为 d=123&thread_id=456 。 虽 然 
通过 对 RawQuery 字段 的 值 进行 语法 分 析 可 以 获取 到 键 值 对 格式 的 查询 
参数 ， 但 直接 使 用 Request 结构 的 Form 字段 来 获取 这 些 键 值 对 会 更 方 
便 一 些 。 本 章 稍 后 就 会 对 Request 结构 的 Form 字段 、PostForm 字段 和 
MultipartForm 字段 进行 介绍 。 














另外 需要 注意 的 一 点 是 ， 如 果 请 求 报 文 是 由 浏览 器 发 送 的， 那么 程 
序 将 无 法 通过 URL 结构 的 Fragment 字段 获取 URL 的 片段 部 分 。 本 书 在 
第 1 章 中 就 提 到 过 ， 浏 览 器 在 同 服务 器 发 送 请 求 之 前 ， 会 将 URL 中 的 万 
段 部 分 剔除 掉 一 一 因为 服务 器 接收 到 的 都 是 不 包含 片段 部 分 的 URL， 所 
以 程序 自然 也 无 法 通过 Fragment 字段 去 获取 URL 的 片段 部 分 了 ， 造 成 
这 个 问题 的 原因 在 于 浏览 器 ， 与 我 们 正在 使 用 的 net/http 库 无 
AX. URL 结构 的 Fragment 字段 之 所 以 会 存在 ， 是 因为 并 非 所 有 请 求 都 
来 自 浏览 器 : 除了 浏览 器 发 送 的 请 求 之 外 ， 服 务 器 还 可 能 会 接收 到 
HTTP 和 客户 端 库 、Angular 这 样 的 客户 端 框架 或 者 某 些 其 他 工具 发 送 的 请 
求 ， 此 外 别 筷 了 ， 不 仅 服务 器 程序 可 以 使 用 Request 结构 ， 客 户 端 库 也 
同样 可 以 把 Request 结构 用 作 自 己 的 一 部 分 。 


4.1.3 请求 首 部 








请 求 和 响应 的 首部 都 使 用 Header 类 型 描述 ， 这 种 类 型 使 用 一 个 映 
射 来 表示 HITP 首 部 中 的 多 个 键 值 对 。Header 类 型 拥有 4 种 基本 方法 ， 
这 些 方 法 可 以 根据 给 定 的 键 执 行 添加 、 删 除 、 获 取 和 设置 值 等 操作 。 


一 个 Header 类 型 的 实例 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 
而 键 的 值 则 是 由 任意 多 个 字符 串 组 成 的 切片 。 为 Header 类 型 设置 首部 
以 及 添加 首部 都 是 非常 简单 的 ， 但 了 解 这 两 种 操作 之 间 的 区 别 有 助 于 更 
好 地 理解 Header 类 型 的 构造 : 在 对 Header 执行 设置 操作 时 ， 给 定 键 的 
值 首 先 会 被 设置 成 一 个 空白 的 字符 串 切 片 ， 然 后 该 切片 中 的 第 一 个 元 素 
会 被 设置 成 给 定 的 首部 值 ; 而 在 对 Header 执行 添加 操作 时 ， 给 定 的 首 
部 值 会 被 添加 到 字符 串 切 片 已 有 元 素 的 后 面 ， 如 图 4-1 所 示 。 

在 为 键 添加 新 的 首部 值 时 ， 一 个 


新 元 素 将 被 追加 到 键 对 应 的 字符 
串 切片 末尾 。 




















图 4-1 一 个 首部 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 值 为 字符 串 切片 








代码 清单 4-2 展 示 了 该 取 请 求 首部 的 方法 。 





代码 清单 42 ” 读 取 请 求 首部 























package main 


import ( 
"fmt" 
"net/http" 
) 


func headers(w http.ResponseWriter, r *http.Request) { 
h := r.Header 
fmt.Fprintln(w, h) 

j 


func main() { 
server :- http.Server( 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/headers", headers) 
server.ListenAndServe() 


} 





这 个 代码 清单 中 展示 的 服务 器 跟 我 们 在 第 3 章 看 到 过 的 服务 如 基本 
上 是 一 样 的 ， 唯 一 的 区 别 在 于 这 个 服务 需 会 把 请 求 的 首部 打印 出 来 。 岁 
4-2 展 示 了 在 OS X 系 统 的 Safari 浏 览 器 上 访问 这 个 服务 器 的 结果 。 


e?» < 127.0.0.1:8080/ headers , (h 


map[Connection:[keep-alive] Accept-Encoding:[gzip, deflate) 
Accept: 

[text /html,application/xhtml*xml,application/xml;q»0.9,*/*;q-0. 
8] User-Agent:[Mozilla/5.0 (Macintosh; Intel Mac OS X 10 10 2) 
AppleWebKit/600.3.18 (KHTML, like Gecko) Version/8.0.3 
$afari/600.3.18]) Accept-Language:[en-us) Dnt:[1]] 








图 4-2 在 浏览 器 上 展示 的 首部 打印 结果 





如 果 想 要 获取 的 是 茶 个 特定 的 首部 ， 而 不 是 请 求 的 所 有 首部 ， 那 么 
可 以 把 服务 器 中 的 


h := r.Header 


THU 


h := r.Header["Accept -Encoding"] 


这 样 一 来 ， 程 序 就 会 得 到 "Accept-Encoding" 键 的 首部 值 : 


[gzip, deflate] 


除 此 之 外 ， 我 们 还 可 以 使 用 以 下 语句 : 





并 得 到 以 下 结果 : 


gzip, deflate 


注意 以 上 两 条 语句 之 间 的 区 别 : 直接 引用 Header 将 得 到 一 个 字符 
串 切片 ， 而 在 Header 上 调用 Get 方法 将 返回 字符 串 形式 的 首部 值 ， 其 
中 多 个 首部 值 将 使 用 逗号 分 隔 。 


4.1.4 ”请 求 主体 


请 求 和 响应 的 主体 都 由 Request 结构 的 Body 字段 表示 ， 这 个 字段 
是 一 个 io.Read Closer 接 口 ， 该 接口 既 包 含 了 Reader 接口 ， 也 包含 了 
Closer 接口 。 其 中 Reader 接口 拥有 Read 方法 ， 这 个 方法 接受 一 个 字 
节 切 片 为 输入 ， 并 在 执行 之 后 返回 被 读 取 内 容 的 字 节 数 以 及 一 个 可 选 的 
错误 作为 结果 ; 而 Closer 接口 则 拥有 Close 方法 ， 这 个 方法 不 接受 任 
何 参数 ， 但 会 在 出 错时 返回 一 个 错误 。 同 时 包含 Reader 接口 和 Closer 
接口 意味 着 用 户 可 以 对 Body 字段 调用 Read 方法 和 Close 方法 。 作 为 例 
子 ， 代 码 清单 4-3 展 示 了 如 何 使 用 Read 方法 读 取 请 求 主体 的 内 容 。 











代码 清单 4-3 ” 读 取 请 求 主 体 中 的 数据 











package main 


import ( 
" fmt "n 
"net/http" 


func body(w http.ResponseWriter, r *http.Request) ( 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) 
fmt.Fprintln(w, string(body)) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/body", body) 
server.ListenAndServe() 





这 段 程序 首先 通过 ContentLength 方法 获取 主体 数据 的 字 节 长 
度 ， 接 着 根据 这 个 长 度 创建 一 个 字 市 数组 ， 然 后 调用 Read 方法 将 主体 
数据 读 取 到 字 节 数组 中 。 


因为 GET 请 求 并 不 包含 报 文 主体 ， 所 以 如 果 我 们 想 要 测试 这 个 服务 
器 ， 就 需要 给 它 发 送 POST 请 求 。 正 如 之 前 所 说 ， 浏 览 器 一 般 需要 通过 
HTML 表 单 才能 发 送 POST 请 求 ， 但 是 因为 本 书 在 下 一 节 才 会 开始 介绍 
HTML 表 单 ， 所 以 这 里 我 们 暂且 就 先 使 用 HTTP 客 户 端 来 测试 服务 器 。 
市 面 上 可 用 的 HTTP 客 户 端 非常 多 ， 既 有 吕 面 版 的 图 形 HTTP 客 户 端 ， 也 
有 浏览 器 插件 或 者 扩展 ， 还 有 cURL 等 命令 行程 序 可 供 选 择 。 


作为 例子 ， 以 下 命令 展示 了 如 何 使 用 cURL 同 服务 器 发 送 一 条 POST 


$ curl -id "first name-sausheong&last name-chang" 127.0.0.1:8080/body 





cURL 在 接收 到 啊 应 之 后 将 同 用 户 返 回 一 段 完整 并 且 示 经 处 理 的 
HTTP 啊 应 ， 其 中 位 于 空 行 之 后 的 束 是 HTTP 的 主体 。 以 下 展示 的 就 是 上 
面 的 cURL 命令 返回 的 啊 应 : 


HTTP/1.1 266 OK 





Date: Tue, 13 Jan 2015 16:11:58 GMT 
Content-Length: 37 
Content-Type: text/plain; charset-utf-8 


first name-sausheong&last name-chang 





因为 Go 语言 提供 了 诸如 FormValue 和 FormFile 这 样 的 方法 来 提取 
通过 POST 方法 提交 的 表单 ， 所 以 用 户 一 般 不 需要 自行 读 取 主体 中 未 经 
处 理 的 表单 ， 本 章 接 下 来 的 一 节 惑 会 介绍 FormValue 和 FormFile 等 方 
法 。 





42 Go 与 HTML 表单 


在 学 习 如 何 从 POST 请 求 中 获取 表单 数据 之 前 ， 让 我 们 先 来 了 解 一 
下 HTML 表 单 。 在 绝 大 多 数 情 况 下 ，POST 请 求 都 是 通过 HTML 表 单 发 送 
的 ， 这 些 表单 看 上 去 通常 会 是 下 面 这 个 样子 : 


«form action="/process" method="post"> 
<input type="text" name="first name"/> 
«input type="text" name-"last name"/» 


«input type-"submit"/» 
«/form» 





«form» 标签 可 以 包围 文本 行 、 文 本 框 、 单 选 按钮 、 复 选 框 以 及 文 
件 上 传 等 多 种 HIML 表 单元 素 ， 而 用 户 则 可 以 把 想 要 传递 给 服务 器 的 数 
据 输 入 到 这 些 元 素 里 面 。 当 用 户 按 下 发 送 按钮 、 又 或 者 通过 某 种 方式 触 
发 了 表单 的 发 送 操作 之 后 ， 用 户 在 表单 中 输入 的 数据 就 会 被 发 送 至 服务 


HET 


AN o 





用 户 在 表单 中 输入 的 数据 会 以 键 值 对 的 形式 记录 在 请 求 的 主体 中 ， 


然后 以 HTTP POST 请 求 的 形式 发 送 至 服务 器 。 因 为 服务 器 在 接收 到 浏览 
器 发 送 的 表单 数据 之 后 ， 还 需要 对 这 些 数据 进行 语法 分 析 ， 从 而 提取 出 
数据 中 记录 的 键 值 对 ， 因 此 我 们 还 需要 知道 这 些 键 值 对 在 请 求 主 体 中 是 
如 何 格式 化 的 。 





HTML 表 单 的 内 容 类 型 (content type) 决定 了 POST 请 求 在 发 送 键 值 
对 时 将 使 用 何 种 格式 ， 其 中 ，HTML 表 单 的 内 容 类 型 是 由 表单 的 
enctype 属性 指定 的 : 
«form action="/process" method="post" enctype-"application/x-www-form-urle 


ncoded"» 
«input type-"text" name-"first name"/» 


«input type-"text" name-"last name"/» 
«input type-"submit"/» 
«/form» 





enctype 属性 的 默认 值 为 application/x-www-form- 
urlencoded 。 浏 览 器 至 少 需 要 文 持 application/x-www-form- 
urlencoded 和 multipart/form-data 这 两 种 编码 方式 。 除 以 上 两 种 


编码 方式 之 外 ，HTML5 还 支持 text/plain 编码 方式 。 


如 果 我 们 把 enctype 属性 的 值 设 置 为 application/x-www-form- 
urlencoded ， 那 么 浏览 器 将 把 HTML 表 单 中 的 数据 编码 为 一 个 连续 
的 “长 查询 字符 串 ”(long query string) : 在 这 个 字符 串 中 ， 不 同 的 键 值 
对 将 使 用 & 符号 分 隔 ， 而 键 值 对 中 的 键 和 值 则 使 用 等 号 = 分 隔 。 这 种 编 
码 方 式 跟 我 们 在 第 1 章 看 到 过 的 URL 编 码 是 一 样 的 ，application/x- 
www-form- urlencoded 编 码 名 字 中 的 urlencoded 一 词 也 由 此 而 来 。 换 
句 话 说 ， 一 个 application/x- www- form-urlencoded 编码 的 HTTP 





请 求 主体 看 上 去 将 会 是 下 面 这 个 样子 的 : 


first_name=sau%26sheong&last_name=chang 


但 是 ， 如 果 我 们 把 enctype 属性 的 值 设 置 为 multipart/form- 
data ， 那 么 表单 中 的 数据 将 被 转换 成 一 条 MIME 报 文 : 表单 中 的 每 个 键 
值 对 都 构成 了 这 条 报 文 的 一 部 分 ， 并 且 每 个 键 值 对 都 带 有 它们 各 目的 内 
容 类 型 以 及 内 容 配置 (disposition〉。 以 下 是 一 个 使 
用 multipart/form-data 编码 对 表单 数据 进行 格式 化 的 例子 : 





WebKitFormBoundaryMPNjKpeO9cLiocMw 
Content-Disposition: form-data; name-z"first name" 


sau sheong 
WebKitFormBoundaryMPNjKpeO9cLiocMw 
Content-Disposition: form-data; name-z"last name" 


WebKitFormBoundaryMPNjKpeO9cLiocMw- - 





既然 表单 同时 支持 application/x-www-form-urlencoded 编码 
和 multipart/form-data 编码 ， 那 么 我 们 该 选择 使 用 哪 种 编码 呢 ? 答 
案 是 ， 如 末 表 单传 送 的 是 简单 的 文本 数据 ， 那 么 使 用 URL 编 但 格式 更 
好 ， 因 为 这 种 编码 更 为 简单 、 高 效 ， 并 且 它 所 需 的 计算 量 要 比 另 一 种 编 
码 少 。 但 是 ， 如 果 表 单 需 要 传送 大 量 数据 (如 上 传 文件 ) 那么 使 
用 multipart /form- data 编 码 格式 会 更 好 一 些 。 在 需要 的 情况 下 ， 用 户 
还 可 以 通过 Base64 编 码 ， 以 文本 方式 传送 二 进 制 数据 。 


到 目前 为 止 ， 我 们 只 讨论 了 如 何 通过 POST 请 求 发 送 表 单 ， 但 实际 
上 通过 GET 请 求 也 是 可 以 发 送 表单 的 一 一 因为 HTML 表 单 的 method 属 


性 的 值 既 可 以 是 POST 也 可 以 是 GET ， 所 以 下 面 这 个 HTML 表 单 也 是 合法 
的 : 


«form action="/process" method="get"> 
<input type="text" name="first name"/> 
«input type-"text" name-"last name"/» 


«input type-"submit"/» 
«/form» 





因为 GET 请 求 并 不 包含 请 求 主体 ， 所 以 在 使 用 GET 方法 传递 表单 
时 ， 表 单数 据 将 以 键 值 对 的 形式 包含 在 请 求 的 URL 里 面 ， 而 不 是 通过 主 
体 传递 。 








在 了 解 了 HTML 表单 癌 服 务 器 传递 数据 的 方法 之 后 ， 让 我 们 回 到 服 
务 器 一 端 ， 学 习 一 下 如 何 使 用 net/http 库 来 处 理 这 些 表单 数据 。 


4.2.1 Form 字 段 


上 一 节 曾 经 提 到 过 ， 为 了 提取 表单 传递 的 键 值 对 数据 ， 用 户 可 能 需 
要 杀 自 对 服务 器 接收 到 的 未 经 处 理 的 表单 数据 进行 语法 分 析 。 但 事实 
上 上， 因为 net/http 库 已 经 提供 了 一 套用 途 相当 广泛 的 函数 ， 这 些 函 数 
一 般 都 能 够 满足 用 户 对 数据 提取 方面 的 需求 ， 所 以 我 们 很 少 需要 目 行 对 
表单 数据 进行 语法 分 析 。 








通过 调用 Request 结构 提供 的 方法 ， 用 户 可 以 将 URL、 主 体 又 或 者 
以 上 两 者 记录 的 数据 提取 到 该 结构 的 Form 、PostForm 和 
MultipartForm 等 字段 当中 。 跟 我 们 平常 通过 POST 请 求 获取 到 的 数据 
一 样 ， 存 储 在 这 些 字 段 里 面 的 数据 也 是 以 键 值 对 形式 表示 的 。 使 
用 Request 结构 的 方法 获取 表单 数据 的 一 般 步 又 是 : 


(D 调用 ParseFornm 方法 或 者 ParseMultipartForm 方法 ， 对 请 
求 进 行 语 法 分 析 。 


(2) 根据 步骤 1 调用 的 方法 ， 访 问 相 应 的 Form 字段 、PostForm 字 
段 或 MultipartForm 字段 。 


代码 清单 4-4 展 示 了 一 个 使 用 ParseFornm 方法 对 表单 进行 语法 分 析 
的 例子 。 


代码 清单 4-4 ”对 表单 进行 语法 分 析 





package main 


import ( 
"fmt" 
"net/http" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
r.ParseForm() 
fmt.Fprintln(w, r.Form) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/process", process) 
server.ListenAndServe() 











这 段 代码 中 最 重要 的 就 是 下 面 这 两 行 : 


r.ParseForm() 
fmt.Fprintln(w, r.Form) 


如 前 所 述 ， 这 段 代码 首先 使 用 了 ParseForm 方法 对 请 求 进行 语法 分 
析 ， 然 后 再 访问 Form 字段 ， 获 取 有 具体 的 表单 。 





现在 ， 让 我 们 来 创建 一 个 短小 精 悍 的 HIML 表 单 ， 并 使 用 它 作 为 客 
户 端 ， 同 代码 清单 4-4 所 示 的 服务 器 发 送 请 求 。 请 创建 一 个 名 
为 client.html 的 文件 ， 并 将 以 下 代码 复制 到 该 文件 中 : 


«html» 
«head» 


«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8" /> 
«title»GoWebProgramming«/title» 

«/head» 

«body» 
«form actionzhttp://127.0.0.1:8080/process?hello-world&thread-123 


wmethod="post" enctype-"application/x-www-form-urlencoded"» 
«input type="text" name-"hello" value-"sau sheong"/» 
«input type="text" name-"post" valuez"456"/» 
«input type-"submit"/» 
«/form» 
«/body» 
«/html» 





这 个 HIML 表 单 可 以 完成 以 下 工作 : 


。 通过 POST 方法 将 表单 发 送 至 地 址 http://localhost:8080/process? 
hello=world&thread=123; 

。 通过 enctype 属性 将 表单 的 内 容 类 型 设置 为 application/x-www- 
form-urlencoded; 

e lf hello-sau sheong 和 post-456 这 两 个 HTML 表单 键 值 对 发 送 : 
服务 器 。 





需要 注意 的 是 ， 这 个 表单 为 相同 的 键 hello 提供 了 两 个 不 同 的 值 ， 


其 中 ， 值 wor1d 是 通过 URL 提 供 的 ， 而 值 sau sheong 则 是 通过 HTML 
表单 中 的 文本 输入 行 提 供 的 。 


因为 客户 端 可 以 直接 在 浏览 器 上 运行 ， 所 以 我 们 并 不 需要 使 用 服务 
虱 来 为 客户 端 提供 服务 ;我 们 要 做 的 就 是 使 用 浏览 器 打开 client.html 
文件 ， 然 后 点 击 表单 中 的 发 送 按钮 。 如 果 一 切 正常 ， 浏 览 器 应 该 会 显示 
以 下 输出 : 


map[thread:[123] hello:[sau sheong world] post:[456]] 


这 是 服务 器 在 对 请 求 进行 语法 分 析 之 后 ， 使 用 字符 串 形 式 显示 出 来 
的 未 经 处 理 的 Form 结构 。 这 个 结构 是 一 个 映射 ， 它 的 键 是 字符 串 ， 而 
键 的 值 是 一 个 由 字符 串 组 成 的 切片 。 因 为 映射 是 无 序 的 ， 所 以 你 看 到 的 
键 值 对 排列 顺序 可 能 和 这 里 展示 的 有 所 不 同 。 但 是 无 论 如 何 ， 这 个 映射 
总 是 会 包含 查询 值 hello=wor1d 和 thread=123 ， 还 有 表单 
值 hello=sau sheong 和 post=456 。 正 如 所 见 ， 这 些 值 都 进行 了 相应 
的 URL 解 码 ， 比 如 在 sau 和 sheong 之 间 就 能 够 正常 地 看 到 空格 ， 而 不 
是 编码 之 后 的 %26 。 











4.2.2 PostForm 字 段 


对 上 一 节 提 到 的 post 这 种 只 会 出 现在 表单 或 者 URL 两 者 其 中 一 个 
地 方 的 键 来 说 ， 执 行 语句 Pr.Form["post"] 将 返回 一 个 切片 ， 切 片 里 面 
包含 了 这 个 键 的 表单 值 或 者 URL 值 ， 就 像 这 样 : [456] 。 而 对 hello 这 
种 同时 出 现在 表单 和 URL 两 个 地 方 的 键 来 说 ， 执 行 语句 
r.Form["hello"] 将 返回 一 个 同时 包含 了 键 的 表单 值 和 URL 值 的 切 





片 ， 并 且 表 单 值 在 切片 中 总 是 排 在 URL 值 的 前 面 ， 就 像 这 样 : [sau 


sheong world]. 


如 果 一 个 键 同 时 拥有 表单 键 值 对 和 URL 键 值 对 ， 但 是 用 户 只 想 要 获 
取 表 单 键 值 对 而 不 是 URL 键 值 对 ， 那 么 可 以 访问 Request 结构 的 
PostForm 字段 ， 这 个 字段 只 会 包含 键 的 表单 值 ， 而 不 包含 任何 同名 键 
的 URL 值 。 举 个 例子 ， 如 果 我 们 把 前 面 代码 中 的 r.Form 语句 改 
为 r .PostForm 语句 ， 那 么 程序 将 打印 出 以 下 结 


map[post:[456] hello:[sau sheong]] 


上 面 这 个 输出 使 用 的 是 application/x-www-form-urlencoded 
内 容 类 型 ， 如 果 我 们 修改 一 下 客户 端的 HTML 表 单 ， 让 它 使 
用 multipart/form-data 作为 内 容 类 型 ， 并 对 服务 器 代码 进行 调整 ， 
让 它 重新 使 用 r.Form 语句 而 不 是 r.PostForm 语句 ， 那 么 程序 将 打印 
出 以 下 结果 : 


map[hello:[world] thread:[123]] 


因为 PostForm 字段 只 支持 application/x-www-form- 
urlencoded 编码 ， 所 以 现在 的 r . Form 语句 将 不 再 返回 任何 表单 值 ， 
而 是 只 返回 URL 碍 询 值 。 为 了 解决 这 个 问题 ， 我 们 需要 通过 
MultipartForm 字段 来 获取 multipart/form-data 编码 的 表单 数据 。 








4.2.3 MultipartForm 7 Et 


为 了 取得 multipart/form-data 编码 的 表单 数据 ， 我 们 需要 用 


到 Request 结构 的 ParseMultipartForm 方法 和 Mu1ltipartForm E 
段 ， 而 不 再 使 用 ParseFornm 方法 和 Form 字段 ， 不 过 
ParseMultipartForm 方法 在 需要 时 也 会 自行 调用 ParseForm 方法 。 
现在 ， 我 们 需要 修改 代码 清单 4-4 中 展示 的 服务 器 程序 ， 把 原来 的 
ParseForm 方法 调用 以 及 打印 语句 蔡 换 成 以 下 两 条 语句 : 


r.ParseMultipartForm(1024) 
fmt.Fprintln(w, r.MultipartForm) 


这 里 的 第 一 行 代码 说 明了 我 们 想 要 从 multipart 编 码 的 表单 里 面 取出 
多 少 字 节 的 数据 ， 而 第 二 行 语句 则 会 打印 请 求 的 MultipartForm 字 
段 。 修 改 后 的 服务 器 在 执行 时 将 打印 以 下 结果 : 


&(map[hello:[sau sheong] post:[456]] map[]) 


因为 MultipartForm 字段 只 包含 表单 键 值 对 而 不 包含 URL 键 值 
对 ， 所 以 这 次 打印 出 来 的 只 有 表单 键 值 对 而 没有 URL 键 值 对 。 男 外 需要 
注意 的 是 ，MultipartForm 字段 的 值 也 不 再 是 一 个 映射 ， 而 是 一 个 包 
含 了 两 个 映射 的 结构 ， 其 中 第 一 个 映射 的 键 为 字符 串 ， 值 为 字符 串 组 成 
的 切 厂 ， 而 第 二 个 映射 则 是 空 的 一 一 这 个 映射 之 所 以 会 为 宇 ， 是 因为 它 
是 用 来 记录 用 户 上 传 的 文件 的 ， 关 于 这 个 映射 的 具体 信息 我 们 将 会 在 接 
下 来 的 一 节 看 到 。 











除了 上 面 提 到 的 几 个 方法 之 外 ，Request 结构 还 提供 了 另外 一 些 方 
法 ， 它 们 可 以 让 用 户 更 容易 地 获取 表单 中 的 键 值 对 。 其 中 ，FormValue 
方法 允许 直接 访问 与 给 定 键 相 关联 的 值 ， 就 像 访问 Form 字段 中 的 键 值 


对 一 样 ， 唯 一 的 区 别 在 于 : 因为 FormValue 方法 在 需要 时 会 自动 调 
用 ParseFornm 方法 或 者 ParseMultipartForm 方法 ， 所 以 用 户 在 执 
fTFormValue 方法 之 前 ， 不 需要 手动 调用 上 面 提 到 的 两 个 语法 分 析 方 


一 < 


这 意味 着 ， 如 宋 我 们 把 以 下 语句 写 到 代码 清单 4-4 所 示 的 服务 器 程 


fmt.Fprintln(w,r.FormValue("hello")) 


| 
A 


并 将 客户 端 表 单 的 enctype 属性 的 值 设置 为 application/x-www- 
form-urlencoded ， 那 么 服务 器 将 打印 出 以 下 结果 : 


sau sheong 


因为 FormValue 方法 即使 在 给 定 键 拥有 多 个 值 的 情况 下 ， 也 只 会 从 
Form 结构 中 取出 给 定 键 的 第 一 个 值 ， 所 以 如 果 想 要 获取 给 定 键 包含 的 
所 有 值 ， 那 么 就 需要 直接 访问 Form 结构 : 








fmt.Fprintln(w, r.FormValue("hello")) 
fmt.Fprintln(w, r.Form) 





上 面 这 两 条 语句 将 产生 以 下 输出 : 


sau sheong 
map[post:[456] hello:[sau sheong world] thread:[123]] 


除了 访问 的 是 PostForm 字段 而 不 是 Form 字段 之 


Ah, PostFormValue 方法 的 作用 跟 上 面 介 绍 的 FormValue 方法 的 作用 
基本 相同 。 下 面 是 一 个 使 用 PostFormValue 方法 的 例子 : 


fmt.Fprintln(w, r.PostFormValue("hello")) 
fmt.Fprintln(w, r.PostForm) 


下 面 是 这 两 行 代码 的 输出 结果 : 





sau sheong 
map[hello:[sau sheong] post:[456]] 


正如 结果 所 示 ，PostFormValue 方法 只 会 返回 表单 键 值 对 而 不 会 
返回 URL 键 值 对 。 


FormValue 方法 和 PostFormValue 方法 都 会 在 需要 时 自动 去 调 
HjParseMultipartForm 方法 ， 因 此 用 户 并 不 需要 手动 调 
用 ParseMultipartForm 方法 ， 但 这 里 也 有 一 个 需要 注意 的 地 方 (至少 
对 于 Go 1.4 厂 本 来 说 ) : 如 果 你 将 表单 的 enctype 设置 成 了 
multipart/form-data ， 然 后 尝试 通过 FormValue 方法 或 
者 PostFormValue 方法 来 获取 键 的 值 ， 那 么 即使 这 两 个 方法 调用 了 
ParseMultipartForm 方法 ， 你 也 不 会 得 到 任何 结果 。 


为 了 验证 这 一 点 ， 让 我 们 再 次 修改 服务 器 程序 ， 给 它 加 上 以 下 代 
fi; 


fmt.Fprintln(w, " X .FormValue("hello")) 
fmt.Fprintln(w, " : .PostFormValue("hello")) 


fmt.Fprintln(w, " " .PostForm) 
fmt.Fprintln(w, " i .MultipartForm) 





以 下 是 在 表单 的 enctype 为 multipart/form-data 的 情况 下 ， 服 
务 器 打印 出 的 结 


(1) world 
(2) 


(3) map[] 
(4) &(map[hello:[sau sheong] post:[456]] map[]} 





结果 中 的 第 一 行 返回 的 是 键 hello 的 值 ， 并 且 这 个 值 来 自 URL 而 不 
是 表单 。 至 于 结果 中 的 第 二 行 和 第 三 行 ， 则 证 明了 前 面 提 到 的 “使 
用 PostFormValue 方法 不 会 得 到 任何 值 ? 这 一 说 法 ， 而 PostForm 字段 
为 空 则 是 引发 这 一 现象 的 罪魁 祸首 。PostForm 字段 之 所 以 会 为 空 ， 是 
因为 FormValue 方法 和 PostFormValue 方法 分 别 对 应 Form 字段 和 
PostForm 字段 ， 而 表单 在 使 用 multipart/form-data 编码 时 ， 表 单 
数据 将 被 存储 到 MultipartForm 字段 而 不 是 以 上 两 个 字段 中 。 结 果 的 
最 后 一 行 证 明 ParseMultipartFornm 方法 的 确 被 调用 了 一 一 用 户 只 要 访 
问 MultipartForm 字段 ， 就 可 以 取得 所 有 表单 值 。 








本 市 介绍 了 Request 结构 的 很 多 相关 字段 以 及 方法 ， 表 4-1 对 它们 
进行 了 回顾 ， 并 阐述 了 各 个 方法 之 间 的 区 别 。 除 此 之 外 ， 这 个 表 还 说 明 
了 调用 哪个 方法 可 以 取得 哪个 字段 的 值 ， 并 阐述 了 这 些 值 的 来 源 以 及 这 
些 值 的 类 型 。 比 如 ， 表 的 第 一 行 就 说 明了 ， 通 过 以 直接 或 间接 的 方式 调 
用 ParseForm 方法 ， 用 户 可 以 将 数据 存储 到 Form 字段 里 面 ， 然 后 用 户 
只 要 访问 Form 字段 ， 束 可 以 取得 编码 类 型 为 application/x-www- 
form-urlencoded 的 URL 数 据 和 表单 数据 。 对 表 4-1 中 列 出 的 字段 以 及 
方法 来 说， 它们 唯一 令 人 感到 遗憾 的 地 方 就 是 ， 这 些 字段 以 及 方法 的 命 
名 规范 并 不 是 特别 让 人 满意 ， 还 有 很 多 有 待 改善 的 地 方 。 




















表 4-1 对 比 Form、PostForm 和 MultipartForm 字段 


键 值 对 的 来 源 型 
需要 调用 的 方法 或 
需要 访问 的 字段 
URL | 表单 |URL 编 码 | Multipart 编 码 
Momm rrr Lb 
Mm rrr b 
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42.4 文件 





multipart/form-data 编码 通常 用 于 实现 文件 上 传 功能 ， 这 种 功 

需要 用 到 file 类 型 的 input 标签 。 代 码 清单 4-5 给 出 的 就 是 之 前 展示 
uer 端 表 单 在 实现 了 文件 上 传 功能 之 后 的 样子 ， 其 中 以 加 粗 方式 呈 
现 的 是 新 增 或 者 经 过 修改 的 代码 。 





代码 清单 45 文件 上 传 





« html» 
« head» 


« meta http-equiv-"Content-Type" content-"text/html; charset-utf-8" /» 
« title»Go Web Programming« /title» 


« /head» 
< body» 

< form actionz"http://localhost:8080/process?hello-world&thread-123" 
method="post" enctype-"multipart/form-data"» 


< input type="text" name-"hello" value-"sau sheong"/» 
< input type="text" name-"post" value-z"456"/» 
< input type-"file" name-"uploaded"» 


« input type-"submit"» 
< /form» 
« /body» 
« /html» 





为 了 能 够 接收 表单 上 传 的 文件 ， 处 理 器 函数 也 需要 做 相应 的 修改 ， 
具体 见 代码 清单 4-6。 











代码 清单 4-6 ”通过 MultipartForm 字段 接收 用 户 上 传 的 文件 














package main 


import ( 
" fmt " 
"io/ioutil" 
"net/http" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
r.ParseMultipartForm(1024) 
fileHeader := r.MultipartForm.File["uploaded"][0] 
file, err := fileHeader.Open() 


if err == nil ( 
data, err :- ioutil.ReadAll(file) 
if err == nil ( 


fmt.Fprintln(w, string(data)) 


func main() { 
server := http.Server( 


Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 


} 





正如 之 前 所 说 ， 服 务 器 在 处 理 文件 上 传 时 首先 要 做 的 就 是 执 
fTParseMultipartForm 方法 ， 接 着 从 MultipartForm 字段 的 File 字 
段 里 面 取 出 文件 头 FileHeader ， 然 后 通过 调用 文件 头 的 Open 方法 来 打 
开 文 件 。 在 此 之 后 ， 服 务 器 会 将 文件 的 内 容 读 取 到 一 个 字 节 数组 中 ， 并 
将 这 个 字 市 数组 的 内 容 打 印 出 来 。 现 在 ， i o eem 
文本 文件 ， 那 么 服务 器 将 把 这 个 文件 的 内 容 打 印 在 浏览 器 


跟 FormValue 方法 和 PostFormValue 方法 类 似 ，net/http 库 也 
提供 了 一 个 FormFile 方法 ， 它 可 以 快速 地 获取 被 上 传 的 文 
ft: FormFile 方法 在 被 调用 时 将 返回 给 定 键 的 第 一 个 值 ， 因 此 它 在 客 
户 端 只 上 传 了 一 个 文件 的 情况 下 ， 使 用 起 来 会 非常 方便 。 代 码 清单 4-7 
展示 了 一 个 使 用 FormFile 方法 的 例子 。 








代码 清单 4-7 使 用 FormFile 方法 获取 被 上 传 的 文件 








func process(w http.ResponseWriter, r *http.Request) { 
file, _, err := r.FormFile("uploaded") 
if err == nil ( 
data, err :- ioutil.ReadAll(file) 
if err == nil ( 


fmt.Fprintln(w, string(data)) 





正如 代码 所 示 ，FormFile 方法 将 同时 返回 文件 和 文件 头 作为 结 


果 。 用 户 在 使 用 FormFile 方法 时 ， 将 不 再 需要 手动 调 
HiParseMultipartForm 方法 ， 只 需要 对 返回 的 文件 进行 处 理 即 可 。 


42.5 “处理 带 有 JSON 主 体 的 POST 请 求 


因为 前 面 的 内 容 一 直 只 使 用 HTML 表 单 发 送 POST 请 求 ， 所 以 到 目 
前 为 止 ， 我们 考虑 的 都 是 如 何 处 理 请 求 主体 中 的 键 值 对 。 但 实际 上 ， 
POST 请 求 并 不 是 只 能 通过 HTML 表 单 发 送 : 诸如 jQuery 这 样 的 客户 端 
库 ， 又 或 者 是 Angular、Ember 这 样 的 客户 端 框架 ， 甚 至 是 Adobe Flash, 
Microsoft Silverlight 这 样 的 技术 ， 都 能 够 发 送 POST 请 求 ， 并 且 这 种 行为 
正在 变 得 越 来 越 常 见 。 











要 注意 的 是 ， 使 用 ParseForm 方法 是 无 法 从 Angular 客 户 端 发 送 
的 POST 请 求 中 获取 JSON 数 据 的 ， 但 使 用 jQuery 这 样 的 JavaScript 库 却 不 
会 出 现 这 样 的 问题 。 





造成 这 一 区 别 的 原因 在 于 ， 不 同 客户 端 使 用 了 不 同 的 方式 编码 
POST 请 求 : jQuery 会 像 HTML 表 单一 样 ， 使 用 application/x-www- 
form-urlencoded 对 POST 请 求 进行 编码 〈 有 具体 做 法 是 ，jQuery 会 把 
POST 请 求 的 Content-Type 首部 的 值 设 置 为 application/Xx-www- 
form-urlencoded ) ， 而 Angular 在 编码 POST 请 求 时 使 用 的 却 
是 application/json 。 因 为 Go 语言 的 ParseForm 方法 只 会 对 表单 数 
据 进 行 语法 分 析 ， ee 编码 ， 所 以 使 用 这 一 
编码 发 送 POST 请 求 的 用 户 自然 也 无 法 通过 ParseForm 方法 获得 任何 数 
Hi o 
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档 对 这 种 行为 进行 说 明 ， 而 程序 员 又 对 他 们 使 用 的 框架 做 了 茶 种 假设 ， 
这 样 一 来 ， 问 题目 然而 然 地 也 瓯 出 现 了 。 


因为 框架 可 以 隐藏 复杂 性 和 实现 细节 ， 所 以 程序 员 应 该 使 用 框架 。 
但 与 此 同时 ， 理 解 框 架 的 工作 方式 ， 了 解 框 架 如 何 化 繁 为 简 ， 也 是 非常 
重要 的 。 否 则 ， 在 使 用 框 染 与 其 他 程序 进行 对 接 的 时 候 ， 就 可 能 会 出 现 
各 种 各 样 的 问题 。 





到 目前 为 止 ， 本 章 已 经 对 “如 何 处 理 请 求 ” 这 一 问题 做 了 足够 多 的 介 
绍 ， 现 在 ， 是 时 候 讲 讲 如 何 同 用 户 发 送 啊 应 了 。 


4.3 ResponseWriter 


首先 创建 一 个 Response 结构 ， 接 着 将 数据 存储 到 这 个 结构 里 面 ， 
最 后 将 这 个 结构 返回 给 客户 端 一 一 如 果 你 认为 服务 器 是 通过 这 种 方式 问 
客户 端 返 回响 应 的 ， 那 么 你 就 错 了 : 服务 器 在 向 客户 端 返回 响应 的 时 
候 ， 真 正 需 要 用 到 的 是 ResponseWriter 接口 。 








ResponseWriter 是 一 个 接口 ， 处 理 器 可 以 通过 这 个 接口 创建 
HTTP 啊 应 。ResponseWriter 在 创建 啊 应 时 会 用 到 http.response £i 
构 ， 因 为 该 结构 是 一 个 非 导出 C(nonexported) 的 结构 ， 所 以 用 户 只 能 通 
过 ResponseWriter 来 使 用 这 个 结构 ， 而 不 能 直接 使 用 它 。 


为 什么 要 以 传 值 的 方式 将 ResponseWriter 传 递 给 ServeHTTP 





在 阅读 了 本 章 前 面 的 内 容 之 后 ， 有 的 读者 可 能 会 感到 疑惑 一 一 ServeHTTP 为 什么 要 接受 
ResponseWriter 接口 和 一 个 指向 Request 结构 的 指针 作为 参数 呢 ? 接受 Request 结构 指针 
| 的 原因 很 简单 : 为 了 让 服务 器 能 够 察觉 到 处 理 器 对 Request 结构 的 修改 ， 我 们 必须 以 传 引用 












































(pass by reference) 而 不 是 传 值 (pass by value) 的 方式 传递 Request 结构 。 但 是 另 一 方面 ， 
为 什么 ServeHTTP 却 是 以 传 值 的 方式 接受 ResponseWriter WE? 难道 服务 器 不 需要 知道 处 理 
器 对 ResponseWriter 所 做 的 修改 吗 ? 






































对 于 这 个 问题 ， 如 果 我 们 深入 探究 net/http 库 的 源码 ， 就 会 发 现 ResponseWriter 实际 
上 就 是 response 这 个 非 导 出 结构 的 接口 ， 而 ResponseWriter 在 使 用 response 结构 时 ， 传 
递 的 也 是 指向 response 结构 的 指针 ， 这 也 就 是 说 ，ResponseWriter 是 以 传 引用 而 不 是 传 值 
的 方式 在 使 用 response 结构 。 




































































换 句 话说 ， 实 际 上 ServeHTTP 函数 的 两 个 参数 传递 的 都 是 引用 而 不 是 值 一 一 虽 
然 ResponseWriter 看 上 去 像 是 一 个 值 ， 但 它 实际 上 却 是 一 个 带 有 结构 指针 的 接口 。 























ResponseWriter 接口 拥有 以 下 3 个 方法 : 


e Write; 
e WriteHeader; 


e Header . 
X] ResponseWriterZt 1] 5 A 


Write 方法 接受 一 个 字 市 数组 作为 参数 ， 并 将 数组 中 的 字 节 写 入 
HITP 啊 应 的 主体 中 。 如 果 用 户 在 使 用 Nrite 方法 执行 号 入 操作 的 时 
候 ， 没 有 为 首部 设置 相应 的 内 容 类 型 ， 那 么 啊 应 的 内 容 类 型 将 通过 检测 
被 写 入 的 前 512 字 市 决定 。 代 码 清单 4-8 展 示 了 Write 方法 的 用 法 。 














代码 清单 4-8 ”使 用 Write 方法 向 客户 端 发 送 响应 





package main 


import ( 
"net/http" 
) 


func writeExample(w http.ResponseWriter, r *http.Request) ( 


str := "«html» 
«head»«title»Go Web Programming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 
«/htm1»^ 
w.Write([]byte(str)) 
j 


func main() { 
server :- http.Server( 
Addr: "127.0.0.1:8080", 


j 
http.HandleFunc("/write", writeExample) 
server.ListenAndServe() 





这 上 段 代 码 通 过 调用 Write 771534 — EHTML ^£ TT 5A f HTTP 
应 的 主体 中 。 通 过 向 服务 器 发 送 以 下 命令 : 


curl -i 127.0.0.1:8080/write 


我 们 可 以 得 到 以 下 响应 : 


HTTP/1.1 200 OK 


Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 
Content-Type: text/html; charset-utf-8 


«html» 


«head»«title»GoWebProgramming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 
«/html» 




















注意 ， 尽 管 我 们 没有 色目 为 啊 应 设置 内 容 类 型 ， 但 程序 还 是 通过 检 
测 自动 设置 了 正确 的 内 容 类 型 。 








WriteHeader 方法 的 名 字 带 有 一 点 儿 误 叶 性 质 ， 它 并 不 能 用 于 设 


置 啊 应 的 首部 Header 方法 才 是 做 这 件 事 的 ) : WriteHeader 方法 接 
受 一 个 代表 HTTP 啊 应 状态 码 的 整数 作为 参数 ， 并 将 这 个 整数 用 作 HTTP 
啊 应 的 返回 状态 码 ， 在 调用 这 个 方法 之 后 ， 用 户 可 以 继续 对 
ResponseWriter 进行 写 入 ， 但 是 不 能 对 响应 的 首部 做 任何 写 入 操作 。 
如 果 用 户 在 调用 Write 方法 之 前 没有 执行 过 WriteHeader 方法 ， 那 么 
程序 默认 会 使 用 200 OK 作为 响应 的 状态 码 。 








WriteHeader 方法 在 返回 错误 状态 码 时 特别 有 用 : 如 果 你 定义 了 
一 个 API， 但 是 尚未 为 其 编写 具体 的 实现 ， 那 么 当 客 户 端 访问 这 个 API 
的 时 候 ， 你 可 能 会 希望 这 个 API 返 回 一 个 5861 Not Implemented， 状 态 
码 ， 代 码 清单 4-9 通 过 添加 新 的 处 理 器 实现 了 这 一 需求 。 顺 带 一 提 ， 千 
万 别 筷 了 使 用 HandleFunc 方法 将 新 处 理 器 绑 定 到 DefaultServeMux 
多 路 复 用 器 里 面 ! 





代码 清单 4-9 ”通过 WriteHeader 方法 将 状态 码 写 入 到 响应 当中 











package main 


import ( 
"fmt" 
"net/http" 
) 


func writeExample(w http.ResponseWriter, r *http.Request) ( 
str := "«html» 
«head»«title»Go Web Programming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 
«/htm1»^ 
w.Write([]byte(str)) 


} 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader(501) 
fmt.Fprintln(w, "No such service, try next door") 


} 


func main() { 
server :- http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
server.ListenAndServe() 





通过 cURL 访问 刚刚 添加 的 新 处 理 器 : 


curl -i 127.0.0.1:8080/writeheader 


我 们 将 得 到 以 下 啊 应 : 


HTTP/1.1 561 Not Implemented 

Date: Tue, 13 Jan 2015 16:20:29 GMT 
Content-Length: 31 

Content-Type: text/plain; charset-utf-8 


No such service, try next door 





最 后 ， 通 过 调用 Header 方法 可 以 取得 一 个 由 首部 组 成 的 映射 〈 关 
于 首部 的 有 具体 细节 在 4.1.3 节 曾经 讲 过 ) ， 修 改 这 个 映射 就 可 以 修改 首 
部 ， 修 改 后 的 首部 将 被 包含 在 HTTP 响 应 里 面 ， 并 随 着 响应 一 同 发 送 至 
客户 端 。 






































代码 清单 4-10 ”通过 编写 首部 实现 客户 端 重 定向 
































package main 


import ( 
"fmt" 
"net/http" 


func writeExample(w http.ResponseWriter, r *http.Request) ( 
str := "«html» 
«head»«title»Go Web Programming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 
«/htm1»^ 
w.Write([]byte(str)) 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader(501) 
fmt.Fprintln(w, "No such service, try next door") 


} 


func headerExample(w http.ResponseWriter, r *http.Request) ( 
w.Header().Set("Location", "http://google.com") 
w.WriteHeader(302) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 
server.ListenAndServe() 





c Lu MI M cun d 除了 将 状 
态 码 设置 成 了 362 之 外 ， 它 还 给 啊 应 添加 了 一 个 名 为 Location 的 首 
部 ， 并 将 这 个 首部 的 值 设置 成 了 重 定向 的 目的 地 。 需 要 注意 的 是 ， 因 
为 WriteHeader 方法 在 执行 完毕 之 后 就 不 允许 再 对 首部 进行 写 入 了 ， 
所 以 用 户 必 须 先 写 入 Location 首部 ， 然 后 再 写 入 状态 码 。 现 在 ， 如 果 
我 们 在 浏览 器 里 面 访问 这 个 处 理 器 ， 那 么 浏览 吉 将 被 重 定向 到 Google。 


男 一 方面 ， 如 果 我 们 使 用 cURL 访问 这 个 处 理 器 : 


curl -i 127.0.0.1:8080/redirect 


[L CR 


那么 cURL 将 获得 以 下 响应 ; 


HTTP/1.1 302 Found 
Location: http://google.com 
Date: Tue, 13 Jan 2015 16:22:16 GMT 


Content-Length: 6 
Content-Type: text/plain; charset-utf-8 





最 后 ， 让 我 们 来 学 习 一 下 通过 ResponseWriter 直接 向 客户 端 返 回 
JSON 数 据 的 方法 。 代 码 清单 4-11 展 示 了 如 何以 JSON 格 式 将 一 个 名 
为 Post 的 结构 返回 给 客户 端 。 


代码 清单 4-11 编写 JSON 输 出 























package main 


import ( 
"fmt" 
"encoding/json" 
"net/http" 

) 


type Post struct ( 
User string 
Threads []string 


} 


func writeExample(w http.ResponseWriter, r *http.Request) { 
str := "«html» 
«head»«title»Go Web Programming«/title»«/head» 
«body»«h1»Hello World«/h1»«/body» 
«/htm1»^ 
w.Write([]byte(str)) 


} 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader(501) 
fmt.Fprintln(w, "No such service, try next door") 


func headerExample(w http.ResponseWriter, r *http.Request) ( 
w.Header().Set("Location", "http://google.com") 
w.WriteHeader(302) 


} 


func jsonExample(w http.ResponseWriter, r *http.Request) { 
w.Header().Set("Content-Type", "application/json") 
post := &Post( 
User: "Sau Sheong", 
Threads: []string("first", "second", "third"), 
} 
json, _ := json.Marshal(post) 
w.Write(json) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 
http.HandleFunc("/json", jsonExample) 
server.ListenAndServe() 








这 段 代码 中 的 jsonExample 处 理 器 就 是 这 次 的 主角 。 因 为 本 书 将 
在 第 7 章 进 一 步 介 绍 JSON 格 式 ， 所 以 不 了 解 JSON 格 式 的 读者 也 不 必 过 
于 担心 ， 目 前 来 说 ， 你 只 需要 知道 变量 json 是 一 个 由 Post 结构 序列 化 
而 成 的 JSON 字 符 串 就 可 以 了 。 





这 上段 程序 首先 使 用 Header 方法 将 内 容 类 型 设置 
成 application/json ， 然 后 调用 Write 方法 将 JSON 字 符 串 写 
AResponseWriter 中 。 现 在 ， 如 果 我 们 执行 cURL 命 令 : 


curl -i 127.0.0.1:8080/json 





那么 它 将 返回 以 下 啊 应 : 


HTTP/1.1 266 OK 

Content-Type: application/json 
Date: Tue, 13 Jan 2015 16:27:01 GMT 
Content-Length: 58 


("User":"Sau Sheong","Threads":["first"," second", "third"]) 





4.4 cookie 


本 书 在 第 2 章 曾 经 简单 地 介绍 过 如 何 使 用 cookie 创 建 身 份 验证 会 话 ， 
本 市 将 在 前 文 的 基础 上 ， 更 加 深入 地 研究 cookie 的 使 用 方法 ， 并 把 
cookie 应 用 在 更 为 常见 的 客户 端 持久 化 场景 中 ， 而 不 仅仅 用 它 创 建 会 
话 。 








cookie 是 一 种 存储 在 客户 端的 、 体 积 较 小 的 信息 ， 这 些 信息 最 初 都 
是 由 服务 堪 通 过 HTTP 啊 应 报 文 发 送 的 。 每 当 客 户 端 癌 服务 器 发 送 一 个 
HTTP 请 求 时 ，cookie 都 会 随 痢 请 求 被 一 同 有 发 送 至 服务 器 。cookie 的 设计 
本 意 是 要 克服 HITP 的 无 状态 性 ， 虽 然 cookie 并 不 是 完成 这 一 目的 的 唯一 
方法 ， 但 它 却 是 最 常用 也 最 流行 的 方法 之 一 : 整个 计算 机 行业 的 收入 都 
建立 在 cookie 机 制 之 上 ， 对 互联 网 广告 领域 来 说 ， 更 是 如 此 。 

cookie 的 种 类 有 很 多 ， 其 中 一 些 还 拥有 非常 有 趣 的 名 字 ， 如 超级 
cookie、 第 三 方 cookie 以 及 僵尸 cookie。 但 总 的 来 说 ， 大 多 数 cookie 都 可 
以 被 划分 为 会 话 cookie 和 持久 cookie 两 种 类 型 ， 而 其 他 类 型 的 cookie 通 常 
都 是 持久 cookie 的 变种 。 


4.4.1 Go 与 cookie 


cookie 在 Go 语言 里 面 用 Cookie 结构 表示 ， 这 个 结构 的 定义 如 代码 
清单 4-12 所 示 。 


代码 清单 4-12 Cookie 结构 的 定义 





type Cookie struct { 
Name string 
Value string 
Path string 
Domain string 
Expires time.Time 
RawExpires string 


MaxAge int 
Secure bool 
HttpOnly bool 

Raw string 
Unparsed []string 





E DS 字段 的 cookie 通 常 称 为 会 话 cookie 或 者 临时 
cookie， 这 种 cookie 在 浏览 器 关闭 的 时 候 就 会 自动 被 移 除 。 相 对 而 言 ， 
设置 了 Expires 字段 的 cookie 通 常 称 为 持久 cookie， 这 种 cookie 会 一 直 存 
在 ， 直 到 指定 的 过 期 时 间 来 临 或 者 被 手动 删除 为 止 。 


Expires 字段 和 MaxAge 字段 都 可 以 用 于 设置 cookie 的 过 期 时 间 ， 
其 中 Expires 字段 用 于 明确 地 指定 cookie 应 该 在 什么 时 候 过 期 ， 
而 MaxAge 字段 则 指明 了 cookie 在 被 浏览 器 创建 出 来 之 后 能 够 存活 多 少 
秒 。 之 所 以 会 出 现 这 两 种 截然 不 同 的 过 期 时 间 设 置 方式 ， 是 因为 不 同 浏 
览 右 使 用 了 各 不 相同 的 cookie 实 现 机 制 ， 跟 Go 语言 本 喘 的 设计 无 关 。 虽 
然 HITP 1.1 中 废弃 了 Expires ， 推 荐 使 用 MaxAge 来 代 奉 Expires ， 但 
几乎 所 有 浏览 器 都 仍然 支持 Expires ; 而且 ， 微 软 的 下 6、IE 7 和 IE 8 都 
不 文 持 MaxAge 。 为 了 让 cookie 在 所 有 浏览 器 上 都 能 够 正常 地 运作 ， 





个 实际 的 方法 是 只 使 用 Expires ， 或 者 同时 使 用 Expires 和 MaxAge 。 
4.4.2 ”将 cookie 发 送 至 浏览 器 


Cookie 结构 的 String 方法 可 以 返回 一 个 经 过 序列 化 处 理 的 
cookie， 其 中 Set-Cookie 响应 首部 的 值 就 是 由 这 些 序列 化 之 后 的 cookie 
组 成 的 。 代 码 清单 4-13 展 示 了 如 何 使 用 string 方法 去 序列 化 cookie， 以 
及 如 何 将 这 些 序列 化 之 后 的 cookie 发 送 至 客户 端 。 

















代码 清单 4-13” 问 浏览 器 发 送 cookie 





package main 


import ( 
"net/http" 
) 


func setCookie(w http.ResponseWriter, nr *http.Request) { 
C1 := http.Cookie( 
Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


= http.Cookie( 

Name: "second cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


w.Header().Set("Set-Cookie", ci.String()) 
w.Header().Add("Set-Cookie", c2.String()) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set cookie", setCookie) 
server.ListenAndServe() 





这 上 段 代 码 首 先 使 用 Set 方法 添加 第 一 个 cookie， 然 后 再 使 用 Add 方 
法 添加 第 二 个 cookie。 现 在 ， 打 开 浏 览 器 并 访问 
http://127.0.0.1:8080/set _cookie， 如 果 一 切 正常 ， 你 将 在 浏览 器 的 Web 
Inspector CH ÆA) 中 看 到 网 4-3 所 示 的 cookie。《〈 图 中 展示 的 是 Safari 浏 
览 器 附带 的 Web Inspector, 18y aee 浏览 器 ， 在 相应 工具 中 
看 到 的 cookie 和 这 里 展示 的 应 该 都 是 一 样 的 。 








eoe Web Inspector — 127.0.0.1 — set cookie 
- 
Xx » 1 11.1ms 
Resources Timelines Debugger Console Inspect 
《 (9 Cookies 
<5 set cookie — 127.0.0.1 » | Name Value Domain Path Expires Size HTTP Secure 
6 Cookies — 127.0.0.1 second cookie Manning Publication Co 127.0.0.1 / Session 358 v 
EH = 
E Local Storage — 127.0.0.1 first cookie Go Web Programming 127.0.0.1 / Session 308 v 
FT 
EH Session Storage — 127.0.0.1 





图 4-3 ”使 用 Safari 浏 览 器 的 Web Inspector 查 看 之 前 设置 的 cookie 


除了 Set 方法 和 Add 方法 之 外 ，Go 语 言 还 提供 了 一 种 更 为 快捷 方便 
的 cookie 设 置 方法 ， 那 就 是 使 用 net/http 库 中 的 SetCookie 方法 。 作 
为 例子 ， 代 码 清单 4-14 展 示 了 如 何 使 用 SetCookie 方法 实现 与 代码 清单 
4-13 相 同 的 设置 操作 ， 其 中 加 粗 展 示 的 部 分 就 是 修改 了 的 代码 。 








代码 清单 4-14 使 用 SetCookie 方法 设置 cookie 


func setCookie(w http.ResponseWriter, r *http.Request) { 


C1 := http.Cookie( 
Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


C2 := http.Cookie( 
Name: "second cookie", 
Value: "Manning Publications Co", 
HttpOnly: true, 


http.SetCookie(w, &c1) 


http.SetCookie(w, &c2) 





这 两 种 cookie 设 置 方式 区 别 并 不 大 ， 唯 一 需要 注意 的 是 ， 在 使 
用 SetCookie 方法 设置 cookie 时 ， 传 递 给 方法 的 应 该 是 指向 Cookie 结 
构 的 指针 ， 而 不 是 Cookie 结构 本 身 。 


4.4.3 ”从 浏览 器 获取 cookie 


在 学 习 了 如 何 将 cookie 存 储 到 客户 并 之 后 ， 现 在 让 我 们 来 看 看 如 何 
从 客户 端 获 取 cookie， 代 码 清单 4-15 展 示 了 这 一 操作 的 具体 实现 方法 。 

















代码 清单 4-15 ”从 请 求 的 首部 获取 cookie 





Jn 
Im. 








package main 


import ( 
"fmt" 
"net/http" 
) 


func setCookie(w http.ResponseWriter, r *http.Request) ( 
C1 := http.Cookie( 
Name: "first cookie", 
Value: "Go Web Programming", 


HttpOnly: true, 


c2 := http.Cookie( 
Name: "second cookie", 
Value: "Manning Publications Co", 
HttpOnly: true, 


http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 
} 


func getCookie(w http.ResponseWriter, r *http.Request) { 
h := r.Header["Cookie"] 
fmt.Fprintln(w, h) 

} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set cookie", setCookie) 
http.HandleFunc("/get cookie", getCookie) 
server.ListenAndServe() 





在 重新 编译 并 且 重 新 启动 这 个 服务 器 之 后 ， 使 用 浏览 器 访问 
http://127.0.0.1:8080/get_cookie， 将 会 在 浏览 器 上 看 到 以 下 结果 : 


[first cookie-Go Web Programming; second cookie-Manning Publications Co] 





语句 r.Header["Cookie"] 返回 了 一 个 切片 ， 这 个 切片 包含 了 一 个 
字符 串 ， 而 这 个 字符 串 又 包含 了 客户 端 发 送 的 任意 多 个 cookie。 如 采用 
户 想 要 取得 单独 的 键 值 对 格式 的 cookie， 就 需要 自行 对 
r.Header["Cookie"] 返回 的 字符 串 进行 语法 分 析 。 不 过 Go 也 提供 了 
一 些 其 他 方法 ， 让 用 户 可 以 更 容易 地 获取 cookie， 代 码 清单 4-16 展 示 了 
i — 8 


yy 






































代码 清单 4-16 ”使 用 Cookie 方法 和 Cookie 方法 











package main 


import ( 
"fmt" 
"net/http" 


) 


func setCookie(w http.ResponseWriter, r *http.Request) ( 
c1 := http.Cookie( 
Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


:= http.Cookie( 

Name: "second cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 


} 


func getCookie(w http.ResponseWriter, r *http.Request) { 
C1, err :- r.Cookie("first cookie") 


if err != nil { 
fmt.Fprintln(w, "Cannot get the first cookie") 
} 
Cs := r.Cookies() 
fmt.Fprintln(w, c1) 
fmt.Fprintln(w, cs) 
} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set cookie", setCookie) 
http.HandleFunc("/get cookie", getCookie) 
server.ListenAndServe() 





Go 语言 为 Request 结构 提供 了 一 个 Cookie 方法 ， 正 如 代码 清单 4- 
16 中 的 加 粗 行 所 示 ， 这 个 方法 可 以 获取 指定 名 字 的 cookie。 如 果 指 定 的 
cookie 不 存在 ， 那 么 方法 将 返回 一 个 错误 。 因 为 Cookie 方法 只 能 获取 
单个 cookie， 所 以 如 果 想 要 同时 获取 多 个 cookie， 束 需要 用 到 Request 
结构 的 Cookies 方法 : Cookies 方法 可 以 返回 一 个 包含 了 所 有 cookie 的 
切片 ， 这 个 切片 跟 访问 Header 字段 时 获取 的 切片 是 完全 相同 的 。 在 重 
新 编译 并 且 重 新 启动 服务 器 之 后 ， 访 问 http:/127.0.0.1:8080/get_cookie， 
浏览 器 将 显示 以 下 内 容 : 








first cookie-Go Web Programming 


[first cookie-Go Web Programming second cookie-Manning Publications Co] 





因为 上 面 展示 的 代码 在 设置 cookie 时 并 没有 为 这 些 cookie 设 置 相应 
的 过 期 时 间 ， 所 以 它们 都 是 会 话 cookie。 为 了 证 明 这 一 点 ， 我 们 只 需要 
退出 并 重启 浏览 器 (注意 ， 不 要 只 关闭 浏览 器 的 标签 ， 一定 要 完全 退出 
浏览 器 才 可 以 ) ， 然 后 再 次 访问 http://127.0.0.1:8080/get_cookie， 就 会 发 
现 之 前 设置 的 cookie 已 经 消失 了 。 








4.4.4 ”使 用 cookie 实 现 闪 现 消 息 


本 书 的 第 2 章 曾 经 介绍 过 如 何 使 用 cookie 管 理 用 户 登 录 会 话 ， 在 对 
cookie 有 了 更 多 了 解 之 后 ， 现 在 是 时 候 来 考虑 一 下 怎样 把 cookie 应 用 到 
更 多 地 方 了 。 


为 了 回 用 户 报告 茶 个 动作 的 执行 情况 ， 应 用 程序 有 时 候 会 癌 用 户 展 
示 一 条 简短 的 通知 消 轧 ， 比 如 说 ， 如 果 一 个 用 户 答 试 在 论坛 上 发 表 一 篇 
帖子 ， 但 是 这 篇 帖子 因为 茶 种 原因 而 发 表 失 败 了 ， 那 么 论坛 应 该 问 这 个 











用 户 展示 一 条 帖子 发 布 失 败 的 消息 。 根 据 本 书 之 前 提 到 过 的 最 小 惊讶 原 
则 ， 这 种 通知 消 恕 应 该 出 现在 用 户 当 前 所 在 的 页 面 ， 但 是 在 通常 情况 
下 ， 用 户 在 访问 这 个 页 面 时 却 不 应 该 看 到 这 样 的 消息 。 因 此 ， 程 序 实际 
上 要 做 的 是 在 某 个 条 件 被 满足 时 ， 才 在 页 面 上 显示 一 条 临时 出 现 的 消 
居 ， 这 样 用 户 在 刷新 页 面 之 后 就 不 会 再 看 见 相同 的 消 恩 了 一 一 我 们 把 这 
种 临时 出 现 的 消息 称 为 内 现 消 息 (flash message) 。 























实现 内 现 消息 的 方法 有 很 多 种 ， 但 最 常用 的 方法 是 把 这 些 消息 存储 
在 页 面 刷新 时 就 会 被 移 除 的 会 话 cookie 里 面 ， 代 码 清单 4-17 展 示 了 如 何 
使 用 Go 语言 实现 这 一 方法 。 
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4-17 ”使 用 Go 的 cookie 实 现 闪 现 消 ， 




















package main 


import ( 
"encoding/base64" 
"fmt" 
"net/http" 
"time" 

) 


func setMessage(w http.ResponseWriter, r *http.Request) { 
msg :- []byte("Hello World!") 
c := http.Cookie( 
Name: "flash", 
Value: base64.URLEncoding.EncodeToString(msg), 


http.SetCookie(w, &c) 


I 

func showMessage(w http.ResponseWriter, r *http.Request) { 
C, err := r.Cookie("flash") 
if err !- nil { 


if err == http.ErrNoCookie { 
fmt.Fprintln(w, "No message found") 


j 
) else { 


rc := http.Cookie( 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, 0), 


http.SetCookie(w, &rc) 


val, _ := base64.URLEncoding.DecodeString(c.Value) 
fmt.Fprintln(w, string(val)) 


} 
} 
func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 
j 


http.HandleFunc("/set message", setMessage) 
http.HandleFunc("/show message", showMessage) 
server.ListenAndServe() 





这 段 代 码 创建 了 setMessage 和 showMessage 两 个 处 理 器 函数 ， 并 
分 别 把 它们 与 路 径 /set_message 以 及 /show_message 进行 绑 定 。 首 
先 ， 让 我 们 来 看 看 setMessage 函数 ， 它 的 定义 非常 简单 直接 ， 如 代码 
清单 4 一 18 所 示 。 





代码 清单 4-18 设置 消息 











func setMessage(w http.ResponseWriter, r *http.Request) { 
msg :- []byte("Hello World!") 
http.Cookie( 
Name: "flash", 


Value: base64.URLEncoding.EncodeToString(msg), 


} 
http.SetCookie(w, &c) 





setMessage 处 理 器 函数 的 定义 跟 之 前 展示 过 的 setCookie 处 理 器 
函数 的 定义 非常 相似 ， 主 要 的 区 别 在 于 setMessage 对 消息 使 用 了 


Base64URL 编 码 ， 以 此 来 满足 啊 应 首部 对 cookie 值 的 URL 编 码 要 求 。 在 
设置 cookie 时 ， 如 果 cookie 的 值 没 有 包含 诸如 空格 或 者 百 分 号 这 样 的 特 
殊 字 符 ， 那 么 不 对 它 进行 编码 也 是 可 以 的 ; 但 是 因为 在 发 送 内 现 消息 
时 ， 消 奶 本 里 通 常会 包含 诸如 空格 这 样 的 字符 ， 所 以 对 cookie 的 值 进行 
编码 就 成 了 一 件 必 不 可 少 的 事情 了 。 








现在 再 来 看 看 showMessage 函数 的 定义 : 


func showMessage(w http.ResponseWriter, r *http.Request) { 
C, err := r.Cookie("flash") 
if err != nil ( 
if err == http.ErrNoCookie ( 
fmt.Fprintln(w, "No message found") 


} 
} else { 
rc := http.Cookie( 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, 0), 


http.SetCookie(w, &rc) 
val, _ := base64.URLEncoding.DecodeString(c.Value) 
fmt.Fprintln(w, string(val)) 





这 个 函数 首先 会 尝试 获取 指定 的 cookie， 如 果 没 有 找到 该 cookie， 
它 就 会 把 变量 err 设置 成 一 个 http.ErrNoCookie 值 ， 并 向 浏览 器 返回 
一 条 “ No message found” 消 息 。 如 果 找 到 了 这 个 cookie， 那 么 它 必 须 完 
成 以 下 两 个 操作 : 


(1) 创建 一 个 同名 的 cookie， 将 它 的 MaxAge 值 设 置 为 负数 ， 并 且 
将 Expires 值 也 设置 成 一 个 已 经 过 去 的 时 间 ; 


(2) 使 用 setCookie 方法 将 刚刚 创建 的 同名 cookie 发 送 至 客户 
端 。 


初 看 上 去 ， 这 两 个 操作 的 目的 似乎 是 要 符 换 已 经 存在 的 cookie， 但 
实际 上 ， 因 为 新 cookie 的 MaxAge 值 为 负数 ， 并 且 Expires 值 也 是 一 个 
已 经 过 去 的 时 间 ， 所 以 这 样 做 实际 上 就 是 要 完全 地 移 除 这 个 cookie。 在 
设置 完 新 cookie 之 后 ， 程 序 会 对 存储 在 旧 cookie 中 的 消息 进行 解码 ， 并 
通过 啊 应 返回 这 条 消息 。 


现在 ， 让 我 们 实际 运行 这 个 服务 器 ， 然 后 打开 浏览 器 并 访问 地 址 
http://localhost:8080/set_ message。 如 果 一 切 顺 利 ， 你 将 在 WebInspector 
中 看 到 图 4-4 所 示 的 cookie。 


eoe Web Inspector — 127.0.0.1 — set message 
— 
O moo T 
Resources Timelines Debugger Console 


Inspect 
< (p Cookies 
‘7 set message — 127.0.0.1 (D ( | Name 


Value Domain Path Expires Size HTTP Secun 
( Cookies — 127.0.0.1 


flash SGVsbG8gV29ybGQh 127.0.0.1 / Session 21B 
BB. Loca! Storage 一 127.0.0.1 


FH Session Storage — 127.0.0.1 








图 4-4 在 Safari 浏 览 器 附带 的 WebInspector 中 查看 已 被 编码 的 闪现 消息 














注意 ， 因 为 图 中 cookie 的 值 已 经 被 Base64 URL 编 码 过 了 ， 所 以 它 初 
看 上 去 就 像 乱 码 一 样 。 不 过 我 们 只 要 使 用 浏览 右 访 问 


http://localhost:8080/show_message， 就 可 以 看 到 解码 之 后 的 真正 的 消 


EH. 
AU e 
Hello World! 


如 果 你 现在 再 去 看 WebInspector， 就 会 发 现 之 前 设置 的 cookie 已 经 
消失 了 : 通过 设置 同名 的 cookie， 程 序 成 功 地 使 用 新 cookie 代 替 了 旧 
cookie; 与 此 同时 ， 因 为 新 cookie 的 MaxAge 值 为 负数 ， 并 且 它 的 
Expires 值 也 是 一 个 已 经 过 去 的 时 间 ， 这 相当 于 命令 浏览 器 删除 这 个 
cookie， 所 以 这 个 新 设置 的 cookie 也 被 移 除了 。 





现在 ， 如 果 刷 新 网 页 ， 或 者 再 次 访问 
http://localhost:8080/show_message， 你 将 看 到 以 下 消息 : 


No message found 


本 章 沿 着 上 一 章 的 脚步 ， 介 绍 了 net/http 在 Web 应 用 开发 方面 提 
供 的 服务 器 并 功能 ， 而 接 下 来 的 一 半 将 对 Web 应 用 的 力 一 个 主要 组 成 部 
分 一 一 模板 一 一 进行 介绍 ， 我 们 将 会 了 解 到 Go 语言 的 模板 以 及 模板 引 
擎 ， 并 学 会 如 何 使 用 它们 为 客户 端 生 成 啊 应 。 





4.5 小 结 


e Go 语言 提供 了 多 种 不 同 的 结构 ， 用 于 表示 HTTP 请 求 的 各 个 不 同 部 
分 ， 从 这 些 结构 里 面 可 以 提取 出 请 求 包含 的 各 项 信息 。 
e Request 结构 的 Form 、PostForm 和 MultipartForm 字段 可 以 让 


户 更 容易 地 提取 出 请 求 中 的 不 同 数据 : 用 户 只 要 调用 ParseForm 方 

法 或 者 ParseMultipartForm 方法 对 请 求 进行 语法 分 析 ， 然 后 访问 

相应 的 字段 ， 就 可 以 取得 请 求 中 包含 的 数据 。 

Form 字段 存储 的 是 来 自 URL 以 及 HTML 表 单 的 URL 编 码 数据 ， 

Post 字段 存储 的 是 来 自 HTML 表 单 的 URL 编 码 数 据 ， 而 

MultipartForm 字段 存储 的 则 是 来 自 URL 以 及 HTML 表 单 的 

multipart 编 码 数据 。 

服务 器 通过 向 ResponseWriter 写 入 首部 和 主体 来 向 客户 端 返 回响 

应 。 

。 通过 向 ResponseWriter 写 入 cookie， 服 务 器 可 以 将 数据 持久 地 存 
储 在 客户 端 上 。 

e coOokie 可 以 用 于 实现 闪现 消息 。 





第 5 章 ” 内 容 展 示 


本 章 主要 内 容 


。 模板 以 及 模板 引擎 

e Go 语言 的 模板 库 text/template 和 htm1/template 
e 模板 中 的 动作 、 管 道 以 及 函数 

。 网 套 的 模板 与 布局 


Web 模 板 就 是 一 些 预先 设计 好 的 HTML 页 面 ， 名 为 模板 引擎 的 软件 
程序 会 通过 重复 地 使 用 这 些 页 面 来 创建 一 个 或 多 个 HTML 页 面 。Web 模 
板 引 擎 是 Web 应 用 框架 的 重要 组 成 部 分 ， 绝 大 多 数 成 熟 的 框架 都 会 拥有 
相应 的 模板 引擎 ， 有 一 小 部 分 框架 的 模板 引擎 是 直接 构 入 框 染 里 面 的 ， 
而 其 他 绝 大 多 数 框架 都 允许 用 户 像 吃 目 助 餐 一 样 ， 根 据 上 自己 的 喜好 选择 
相应 的 模板 引擎 。 











Go 语言 也 不 例外 一 一 尽管 Go 还 是 一 门 相对 较 新 的 编程 语言 ， 但 已 
经 出 现 了 一 些 使 用 Go 语言 构建 的 模板 引擎 ， 除 此 之 外 ，Go 的 标准 库 也 
通过 text/template 和 html/template 这 两 个 库 为 模板 提供 了 强 有 力 
的 支持 ， 并 且 毫 不 意外 地 很 多 Go 框架 都 使 用 了 这 两 个 库 作 为 默认 的 模 
板 引 擎 。 


本 章 将 对 上 面 提 到 的 两 个 库 进 行 介绍 ， 并 说 明 如 何 使 用 它们 生成 
HTML 响 应 。 


5.1 模板 引擎 


如 图 5-1 所 示 ， 模 板 引 警 通过 将 数据 和 模板 组 合 在 一 起 生成 最 终 的 
HTML， 而 处 理 堪 则 负责 调用 模板 引擎 并 将 引擎 生成 的 HIML 返 回 给 客 
户 端 。 


如 前 所 述 ，Web 模 板 引 擎 演变 自 SSI〈 服 务 器 端 包含 ) 技术 ， 并 最 
终 衍 生出 了 诸如 PHP、ColdFusion 和 JSP 这 样 的 Web 编程 语言 。 这 种 演变 
导致 的 一 个 结果 是 模板 引擎 并 没有 相应 的 标准 ， 并 且 对 各 个 因为 不 同 原 
因 创 造 出 来 的 模板 引擎 来 襄 ， 它 们 拥有 的 特性 也 是 五 花 八 门 、 各 不 相同 
的 。 不 过 大 致 来 讲 ， 我 们 可 以 把 模板 引擎 划分 为 两 种 理想 的 类 型 ， 这 两 
种 类 型 的 模板 正好 处 于 两 个 极端 。 


图 5-1 模板 引擎 通过 组 合 数据 和 模板 来 生成 最 终 展示 的 HTML 
e 无 逻辑 模板 引擎 (logic-less template engine) 一 一 将 模板 中 指定 的 
占 位 符 蔡 换 成 相应 的 动态 数据 。 这 种 模板 引 苟 只 进行 字符 串 蔡 换 ， 
而 不 执行 任何 逻辑 处 理 。 无 逻辑 模板 引擎 的 目的 是 完全 分 离 程序 的 








表现 和 逻辑 ， 并 将 所 有 计算 方面 的 工作 都 交 给 处 理 器 完成 。 
RAZ SR S (embedded logic template engine? 将 编程 
语言 代码 和 坐 入 模板 当中 ， 并 在 模板 引擎 泻 染 模板 时 ， 由 模板 引擎 执 
行 这 些 代码 并 进行 相应 的 字符 串 瞧 换 工 作 。 因 为 拥有 在 模板 里 面 赔 
入 逻辑 的 能 力 ， 所 以 这 类 模板 引擎 能 够 变 得 非常 强大 ， 但 与 此 同 
时 ， 这 种 能 力也 会 导致 逻辑 分 散 授 布 在 不 同 的 处 理 器 之 间 ， 使 代码 
变 得 难以 维护 。 











因为 不 需要 进行 逻辑 处 理 ， 所 以 无 逻辑 模板 引擎 的 泻 染 速 度 往往 会 
更 快 一 些 。 一 些 模 板 引 擎 虽然 自称 是 无 逻辑 模板 引擎 ， 但 它们 实际 上 并 
非 只 执行 字符 串 替 换 操作 。 比 如 ，Mustache 虽 然 自称 是 无 逻辑 模板 引 
擎 ， 但 它 实 际 上 也 提供 了 一 些 能 够 执行 条 件 判 断 操 作 和 循环 操作 的 标签 

(tag) 。 





另外 ， 最 极端 的 舱 入 逻辑 模板 引擎 通常 表现 得 跟 普通 的 编程 语言 一 
样 ， 比 如 PHP 就 是 一 个 很 好 的 例子 : PHP 一 开始 是 作为 独立 的 Web 模 板 
引 警 出现 的 ， 但 今 时 今日 的 很 多 PHP 页 面 已 经 很 难看 到 哪怕 一 行 HTML 
代码 ， 我 们 甚至 已 经 不 太 可 能 继续 把 PHP 看 作 是 一 个 模板 引擎 了 ， 实 际 
上 PHP 本 身 就 拥有 很 多 模板 引擎 ， 比 如 ，Smarty 和 Blade 都 是 为 PHP 构 建 
的 。 

















对 于 明 入 迎 辑 模板 引擎 的 最 大 争论 ， 就 是 认为 它 把 表现 和 逻辑 搅 合 
在 了 一 起 ， 并 将 逻辑 分 散在 多 个 不 同 的 地 方 ， 导 致 代码 变 得 难以 维护 。 
而 对 于 无 逻辑 模板 引擎 的 搜 论 则 是 认为 这 种 理想 化 的 模板 引擎 并 不 实 
用 ， 并 且 会 导致 处 理 需 需要 包 合 更 多 逻辑 ， 特 别 是 表现 方面 的 多 辑 ， 并 
因此 给 处 理 需 带 来 不 必要 的 复杂 上 度 。 





在 实际 中 ， 绝 大 多 数 有 用 的 模板 引擎 都 会 介 于 以 上 这 两 种 理想 的 模 
板 引 擎 之 间 ， 其 中 有 些 模板 引擎 更 接近 于 无 逻辑 模板 引擎 ， 而 其 他 一 些 
模板 引擎 则 更 接近 于 和 藤 入 逻辑 模板 引擎 。Go 标 准 库 提供 的 模板 引擎 功 
能 大 部 分 都 定义 在 了 text/template 库 当 中 ， 而 小 部 分 与 HTML 相 关 
的 功能 则 定义 在 了 html/template 库 里 面 。 这 两 个 库 相 辅 相 成 : 用 户 
可 以 把 这 个 模板 引擎 当做 无 逻辑 模板 引擎 使 用 ， 但 与 此 同时 ，Go 也 提 
供 了 足够 多 的 欣 入 式 模板 引擎 特性 ， 使 这 个 模板 引擎 用 起 来 既 有 趣 又 强 
Ja 





5.2 Go 的 模板 引擎 


跟 其 他 大 多 数 模板 引擎 一 样 ，Go 语 言 的 模板 引擎 也 是 介 于 无 逻辑 
模板 引擎 和 骨 入 逻辑 模板 引擎 之 间 的 一 种 模板 引擎 。 在 web 应 用 里 面 ， 
模板 引擎 通常 由 处 理 器 负责 触发 。 作 为 例子 ， 图 5-2 展 示 了 处 理 器 调用 
Go 模板 引擎 的 流程 : 处 理 器 首先 调用 模板 引擎 ， 接 着 以 模板 文件 列表 
的 方式 向 模板 引擎 传 入 一 个 或 多 个 模板 ， 然 后 再 传 入 模板 需要 用 到 的 动 
态 数据 ;模板 引擎 在 接收 到 这 些 参数 之 后 会 生成 出 相应 的 HIML， 并 将 
这 些 文件 写 入 到 ResponseWriter 里 面 ， 然 后 由 ResponseNriter 将 
HTTP 响 应 返回 给 客户 端 。 











图 5-2 ”Go 模板 引擎 在 web 应 用 中 的 作用 示意 图 





Go 的 模板 都 是 文本 文档 (其 中 Web 应 用 的 模板 通常 都 是 HTML) ， 
它们 都 租 入 了 一 些 称 为 动作 (action〉 的 指令 。 从 模板 引擎 的 角度 来 
说 ， 模 板 就 是 嵌入 了 动作 的 文本 〈 这 些 文本 通常 包含 在 模板 文件 里 
面 ) ， 而 模板 引 警 则 通过 分 析 并 执行 这 些 文本 来 生成 出 另外 一 些 文本 。 
Go 语言 拥有 通用 模板 引擎 库 text/template ， 它 可 以 处 理 任 意 格式 的 
文本 ， 除 此 之 外 ，Go 语 言 还 拥有 专门 为 HTML 格 式 而 设 的 模板 引擎 库 
html/template 。 模 板 中 的 动作 默认 使 用 两 个 大 括号 {{ 和 }} 包围 ， 如 
果 用 户 有 需要 ， 也 可 以 通过 模板 引擎 提供 的 方法 自行 指定 其 他 定 界 符 
(delimiter) 。 本 章 稍 后 将 对 动作 做 更 详细 的 介绍 ， 在 此 之 前 ， 让 我 们 
先 来 看 一 下 代码 清单 5-1 展 示 的 这 个 非常 简单 的 模板 。 




















代码 清单 5-1 一 个 简单 的 模板 





«IDOCTYPE html» 
«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 


«/head» 


{{ . H) 
</body> 
</html> 





代码 清单 5-1 展 示 的 模板 来 源 于 一 个 名 为 tmp1.html 的 模板 文件 。 
用 户 可 以 拥有 任意 多 个 模板 文件 ， 并 且 这 些 模板 文件 可 以 使 用 任意 后 绥 
名 ， 但 它们 的 类 型 必须 是 可 读 的 文本 格式 。 因 为 上 面 这 段 模板 的 输出 将 
是 一 个 HTML 文 件 ， 所 以 我 们 使 用 了 .html 作为 模板 文件 的 后 级 名 。 


注意 ， 模 板 中 被 两 个 大 括号 包围 的 点 〈. ) 是 一 个 动作 ， 它 指示 模 
板 引 擎 在 执行 模板 时 ， 使 用 一 个 值 去 从 换 这 个 动作 本 身 。 





使 用 Go 的 web 模板 引擎 需要 以 下 两 个 步 又 : 





(1) 对 文本 格式 的 模板 源 进行 语法 分 析 ， 创 建 一 个 经 过 语法 分 析 
的 模板 结构 ， 其 中 模板 源 既 可 以 是 一 个 字符 串 ， 也 可 以 是 模板 文件 中 包 
含 的 内 容 ; 





(20 执行 经 过 语法 分 析 的 模板 ， 将 ResponseWriter 和 模板 所 需 
的 动态 数据 传递 给 模板 引擎 ， 被 调用 的 模板 引擎 会 把 经 过 语法 分 析 的 模 
板 和 传 入 的 数据 结合 起 来 ， 生 成 出 最 终 的 HIML， 并 将 这 些 HTML 传 递 


给 ResponseWriter 。 


代码 清单 5-2 展 示 了 一 个 简单 而 且 具 体 的 模板 引擎 使 用 例子 。 



































代码 清 


package main 


5-2 在 处 理 器 函数 中 触发 模板 引擎 











import ( 


"net/http" 
"html/template" 

) 

func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, "Hello World!") 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 


} 





代码 清单 5-2 展 示 的 服务 器 代码 跟 之 前 展示 过 的 服务 器 代码 非常 相 
似 ， 主 要 的 区 别 在 于 这 次 的 服务 器 使 用 了 一 个 名 为 process 的 处 理 器 函 
数 ， 而 模板 引擎 就 是 由 这 个 函数 负 贡 触发 的 。process 函数 首先 使 
用 ParseFiles 函数 对 模板 文件 tmp1.html 进行 语法 分 
析 ，ParseFiles 函数 在 执行 完毕 之 后 将 返回 一 个 Template 类 型 的 已 
分 析 模 板 和 一 个 错误 作为 结果 ， 不 过 为 了 保持 代码 的 简洁 ， 我 们 这 里 暂 
时 把 这 个 错误 忽略 了 : 


t, _ := template.ParseFiles("tmpl.html") 





在 此 之 后 ，process 函数 会 调用 Execute 方法 ， 将 数据 应 用 
(apply〉 到 模板 里 面 一 一 在 这 个 例子 中 ， 数 据 就 是 字符 串 "Hello 
World!l".: 


t.Execute(w, "Hello World!") 


ResponseWriter 和 数据 会 一 起 被 传 入 Execute 方法 中 ， 这 样 一 
来 ， 模 板 引擎 在 生成 HTML 之 后 就 可 以 把 该 HTML 传 给 
ResponseWriter 了 。 另 外 需要 注意 的 是 ， 因 为 这 个 服务 器 在 指定 模板 
位 置 时 并 没有 给 出 模板 文件 的 绝对 路 径 ， 所 以 我 们 在 运行 这 个 服务 器 的 
时 候 ， 需 要 把 模板 文件 和 服务 器 的 二 进 制 文件 放 到 同一 个 目录 里 面 。 





以 上 展示 的 就 是 模板 引擎 的 最 基本 用 法 ， 正 如 你 所 料 ， 除 了 . 之 
外 ，Go 的 模板 引擎 还 提供 了 其 他 动作 供用 户 使 用 ， 本 章 将 在 稍 后 的 内 
容 中 对 这 些 动作 做 进一步 的 介绍 。 





5.2.1 ”对 模板 进行 语法 分 析 


ParseFiles 是 一 个 独立 的 (standalone〉 函数 ， 它 可 以 对 模板 文件 
进行 语法 分 析 ， 并 创建 出 一 个 经 过 语法 分 析 的 模板 结构 以 供 Execute 方 
法 执行 。 实 际 上 ，ParseFiles 函数 只 是 为 了 方便 地 调用 Template 结 
构 的 ParseFiles 方法 而 设置 的 一 个 函数 一 一 当 用 户 调 用 ParseFiles 
函数 的 时 候 ，Go 会 创建 一 个 新 的 模板 ， 并 将 用 户 给 定 的 模板 文件 的 名 
字 用 作 这 个 新 模板 的 名 字 : 





_ := template.ParseFiles("tmpl.html") 





这 相当 于 创建 一 个 新 模板 ， 然 后 调用 它 的 ParseFiles 方法 : 


:= template.New("tmpl.html") 


:= t.ParseFiles("tmpl.html") 





无 论 是 ParseFiles 函数 还 是 Template 结构 的 ParseFiles 方法 ， 


它们 都 可 以 接受 一 个 或 多 个 文件 名 作为 参数 ， 换 句 话 说 ， 这 两 个 函数 / 
方法 都 是 可 释 参 数 函 数 / 方 法 ， 它 们 可 以 接受 的 参数 数量 是 可 变 的 。 但 
与 此 同时 ， 无 论 这 两 个 函数 /方法 接受 多 少 个 文件 名 作为 输入 ， 它 们 痢 
只 返回 一 个 模板 。 


当 用 户 向 ParseFiles 函数 或 ParseFiles 方法 传 入 多 个 文件 

时 ，ParseFiles 只 会 返回 用 户 传 入 的 第 一 个 文件 的 已 分 析 模 板 ， 并 且 
这 个 模板 也 会 根据 用 户 传 入 的 第 一 个 文件 的 名 字 进 行 命名 ; 至 于 其 他 传 
入 文件 的 已 分 析 模 板 则 会 被 放置 到 一 个 映射 里 面 ， 这 个 映射 可 以 在 之 后 
执行 模板 时 使 用 。 换 句 话说 ， 我 们 可 以 这 样 认为 : 在 问 ParseFiles f£ 
入 单个 文件 时 ，ParseFiles 返回 的 是 一 个 模板 ;而 在 向 ParseFiles 
传 入 多 个 文件 时 ，ParseFiles 返回 的 则 是 一 个 模板 集合 ， 理 解 这 一 点 
能 够 帮助 我 们 更 好 地 学 习 本 章 稍 后 将 要 介绍 的 般 套 模板 技术 。 











对 模板 文件 进行 语法 分 析 的 另 一 种 方法 是 使 用 ParseGlob 函数 ， 跟 
ParseFiles 只 会 对 给 定 文件 进行 语法 分 析 的 做 法 不 同 ，ParseGlob 会 
对 匹配 给 定 模 式 的 所 有 文件 进行 语法 分 析 。 举 个 例子 ， 如 果 目 录 里 面 只 
fjtmpl.html 一 个 HTML 文件 ， 那 么 语句 





t, _ := template.ParseFiles("tmpl.html") 





和 语句 


t, _ := template.ParseGlob("*.html") 





将 产生 相同 的 效果 。 


在 绝 大 多 数 情况 下 ， 程 序 都 是 对 模板 文件 进行 语法 分 析 ， 但 是 在 需 
要 时 ， 程 序 也 可 以 直接 对 字符 串 形式 的 模板 进行 语法 分 析 。 实 际 上 ， 所 
有 对 模板 进行 语法 分 析 的 手段 最 终 都 需要 调用 Parse 方法 来 执行 实际 的 
语法 分 析 操 作 。 比 如 说 ， 在 模板 内 容 相 同 的 情况 下 ， 语 句 





t, _ := template.ParseFiles("tmpl.html") 





和 代码 


tmpl := '"«!DOCTYPE html» 
«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 


t := template.New("tmpl.html") 
t, _ = t.Parse(tmpl) 
t.Execute(w, "Hello World!") 





将 产生 相同 的 效果 。 


到 目前 为 止 ， 本 章 一 直 都 没有 处 理 分 析 模 板 时 可 能 会 产生 的 错误 。 
虽然 Go 语言 的 一 般 做 法 是 手动 地 处 理 错误 ， 但 Go 也 提供 了 另外 一 种 机 
制 ， 专 门 用 于 处 理 分 析 模 板 时 出 现 的 错误 : 


t := template.Must(template.ParseFiles("tmpl.html")) 





Must KA ELELZEGES SARA ROR K RAR R [6] — 1 8 IRL 


板 的 指针 和 一 个 错误 ， 如 果 这 个 错误 不 是 nil ， 那 么 Must 函数 将 产生 
一 个 panic。 在 Go 里 面 ，panic 会 导致 正常 的 执行 流程 被 终止 : 如果 

panic 是 在 函数 内 部 产生 的 ， 那 么 函数 会 将 这 个 panic 返 回 给 它 的 调用 

者 。panic 会 一 直 同 调用 栈 的 上 方 传递 ， 直 至 main 函数 为 止 ， 并 且 程 序 
也 会 因此 而 月 尝 。) 


5.2.2 ”执行 模板 


执行 模板 最 常用 的 方法 就 是 调用 模板 的 Execute 方法 ， 并 问 它 传 
递 ResponseWriter 以 及 模板 所 需 的 数据 。 在 只 有 一 个 模板 的 情况 下 ， 
上 面 提 到 的 这 种 方法 总 是 可 行 的 ， 但 如 果 模 板 不 止 一 个 ， 那 么 当 对 模板 

合 调用 Execute 方法 的 时 候 ，Execute 方法 只 会 执行 模板 集合 中 的 第 
一 个 模板 。 如 果 想 要 执行 的 不 是 模板 集合 中 的 第 一 个 模板 而 是 其 他 模 
板 ， 就 需要 使 用 Execute Template 方 法 。 比 如 ， 对 以 下 语句 来 说 : 














_ := template.ParseFiles("t1.html", "t2.html") 





变量 t 就 是 一 个 包含 了 两 个 模板 的 模板 集合 ， 其 中 第 一 个 模板 名 

为 t1.html ， 而 第 二 个 模板 则 名 为 t2.html (正如 前 面 所 说 ， 除 非 显 式 

地 对 模板 名 进行 修改 ， 否 则 模板 的 名 字 和 后 级 名 将 由 传 入 的 模板 文件 决 
) 。 如 果 对 这 个 模板 集合 调用 Execute 方法 : 


t.Execute(w, "Hello World!") 


就 只 有 模板 t1.html 会 被 执行 。 如 果 想 要 执行 的 是 模板 t2.html 而 不 
是 t1.html ， 则 需要 执行 以 下 语句 





t.ExecuteTemplate(w, "t2.html", "Hello World!") 





在 学 会 了 怎样 调用 模板 引擎 并 使 用 它 去 分 析 和 执行 模板 之 后 ， 接 下 
来 我 们 要 学 习 的 是 如 何 使 用 Go 语言 提供 的 各 种 模板 动作 。 


5.3 动作 


正如 之 前 所 说 ，Go 模 板 的 动作 就 是 一 些 授 入 在 模板 里 面 的 命令 ， 
这 些 命令 在 模板 中 使 用 两 个 大 括号 {{ 和 }} 进行 包围 。Go 拥 有 一 套 非常 
丰富 的 动作 集合 ， 它 们 不 仅 功 能 强大 ， 而 且 还 非常 灵活 多 变 。 本 市 将 讨 
沦 以 下 几 种 主要 的 动作 : 


条 件 动作 ; 
IERIE; 
设置 动作 ; 
包含 动作 。 





除了 以 上 4 种 动作 之 外 ， 本 章 稍 后 还 会 介绍 另外 一 种 重要 的 动作 
一 一 定义 动作 。 如 果 读 者 对 其 他 类 型 的 动作 也 感 兴趣 ， 那 么 可 以 参 
考 text/template 库 的 文档 。 


里 然 初 看 上 去 可 能 会 让 人 感到 惊讶 ， 但 其 实 抬 (. ) 也 是 一 个 动 
作 ， 并 且 是 最 为 重要 的 一 个 ， 它 代表 的 是 传递 给 模板 的 数据 ， 其 他 动作 
和 函数 基本 上 痢 会 对 这 个 动作 进行 处 理 ， 以 此 来 达到 格式 化 和 内 容 展示 
的 目的 。 


5.3.1 条 件 动 作 





条 件 动 作 会 根据 参数 的 值 来 决定 对 多 条 语句 中 的 哪 一 条 语句 进行 求 
值 。 最 简单 的 条 件 动作 的 格式 如 下 : 


{{ if arg }} 


some content 


{{ end }} 


这 个 动作 的 男 一 种 格式 如 下 : 


{{ if arg }} 


some content 


{{ else }} 


other content 


{{ end }} 








以 上 两 种 格式 中 的 arg 都 是 传递 给 条 件 动作 的 参数 。 本 章 稍 后 会 对 
动作 的 参数 做 更 详细 的 介绍 ， 目 前 来 说 ， 我 们 可 以 把 参数 看 作 是 一 个 
值 ， 这 个 值 可 以 是 一 个 字符 串 常量 、 一 个 变量 、 一 个 返回 单个 值 的 函数 
或 者 方法 ， 诸 如 此 类 。 现 在 ， 让 我 们 来 看 一 下 如 何在 模板 中 使 用 这 个 条 
件 动作 。 如 代码 清单 5-3 所 示 ， 我 们 会 在 服务 右上 面 创建 一 个 处 理 器 ， 
这 个 处 理 器 会 随机 地 生成 介 于 0 至 10 之 间 的 随机 整数 ， 然 后 通过 判断 这 
个 随机 整数 是 否 大 于 5 来 创建 出 一 个 布尔 值 ， 并 在 最 后 将 这 个 布尔 值 传 
递 给 模板 。 





























代码 清单 5-3 ”在 处 理 器 里 面 生成 一 个 随机 数 





























package main 


import ( 
"net/http" 
"html/template" 
"math/rand" 
"time" 


) 


func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
rand.Seed(time.Now().Unix()) 
t.Execute(w, rand.Intn(10) » 5) 

} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


} 


http.HandleFunc("/process", process) 
server.ListenAndServe() 





在 此 之 后 ， 我 们 需要 在 模板 文件 tmpl.html 里 面 对 传 入 的 参数 进行 
测试 ， 并 根据 测试 的 结果 ， 在 页 面 上 显示 “Number is greater than 5! 
”和 “Number is 5 or less! ”这 两 条 消息 中 的 一 条 ， 具 体 的 做 法 如 代码 清单 
5-4 所 示 。【〔 正 如 之 前 所 说 ， 动 作 . 代表 的 是 处 理 器 传递 给 模板 的 数据 ， 
在 这 个 例子 中 ，. 代表 的 是 被 传 入 的 布尔 值 。) 











代码 清单 5-4 ”使 用 了 条 件 动作 的 模板 文件 tmp1 .html 


«IDOCTYPE html» 
«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
{{ if . }} 


Number is greater than 5! 
{{ else }} 
Number is 5 or less! 
{{ end }} 
</body> 
«/html» 





5.3.2 ”迭代 动作 


迭代 动作 可 以 对 数组 、 切 片 、 映 射 或 者 通道 进行 入 代 ， 而 在 迭代 循 
环 的 内 部 ， 乓 (.〉 则 会 被 设置 为 当前 被 达 代 的 元 系 ， 束 像 这 样 : 


{{ range array }} 
Dot is set to the element {{ . }} 


{{ end }} 





代码 清单 5-5 展 示 了 一 个 使 用 返 代 动 作 的 例子 。 





代码 清单 5-5 ”和 迭代 动作 示例 








«IDOCTYPE html» 
«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«ul» 
(( range . Jj 
«li»(( . ))«/1i» 
{{ endjj 
«/ul» 
«/body» 
«/html» 





下 面 是 负责 调用 这 个 模板 的 处 理 器 : 


func process(w http.ResponseWriter, r *http.Request) { 
t, := template.ParseFiles("tmpl.html") 
daysOfWeek :- []string("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun" 


t.Execute(w, daysOfWeek) 


} 





这 段 代 码 创建 了 一 个 切片 ， 并 在 切片 里 面包 含 了 周一 到 周 日 的 英文 
缩写 ， 然 后 将 它 传递 给 模板 。 接 着 ， 这 个 切片 会 被 传递 至 语句 {{ 
range . ))'P fj. 里 面 ， 然 后 由 range 动作 对 这 个 切片 中 的 各 个 元 素 
进行 迭代 。 

迭代 循环 中 的 {{ . H 代表 的 是 当前 被 迭代 的 切片 元 素 ， 图 5-3 展 
示 了 浏览 器 展示 的 迭代 结果 。 


eoe 127.0.0.1:8080/process : 由 

















图 5-3 ”使 用 达 代 动作 实现 迭代 
代码 清单 5-6 展 示 了 迭代 动作 的 一 个 变种 ， 这 个 变种 允许 用 户 在 被 
迭代 的 数据 结构 为 空 时 ， 显 示 一 个 备 选 的 〈fallback) 结 


代码 清单 5-6 ” 带 有 备 选 结果 的 迭代 动作 





«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«ul» 


(( range . jj 


«li»(( . ))«/1li» 
{{ else jj 
«li» Nothing to show </li> 
{{ endjj 
«/ul» 
«/body» 
«/html» 





模板 里 面 介 于 {{ else }} 和 {{ end }}+ 之 间 的 内 容 将 在 点 〈. ) 
为 nil 时 显示 。 在 这 个 例子 中 ， 被 显示 的 将 是 文本 “Nothing to show". 


5.3.3 ”设置 动作 


设置 动作 允许 用 户 在 指定 的 范围 之 内 为 点 〈. ) 设置 值 。 比 如 ， 在 
以 下 代码 中 : 


{{ with arg }} 
Dot is set to arg 


{{ end }} 





介 于 {{ with arg }} 和 {{ end }} 之 间 的 点 将 被 设置 为 参数 arg 的 
值 。 再 次 修改 的 tmpl.html 文件 如 代码 清单 5-7 所 示 ， 这 是 一 个 更 为 具 
体 的 例子 。 





代码 清单 5-7 对 点 进行 设置 


<html> 
<head> 








«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 

«title»Go Web Programming«/title» 
«/head» 
«body» 

«div»The dot is (( . ))«/div» 

«div» 

(( with "world"}} 

Now the dot is set to (( . }} 

(( end jj 

</div> 

<div>The dot is {{ . }} again</div> 
</body> 

</html> 





至 于 调用 这 个 模板 的 处 理 器 则 会 将 字符 串 "hello" 传递 给 模板 : 


func process(w http.ResponseWriter, r *http.Request) { 
七 ， := template.ParseFiles("tmpl.html") 
t.Execute(w, hello") 


} 





这 样 一 来 ， 位 于 {{ with "world”}} 之 前 的 点 就 会 因为 处 理 器 传 入 的 
值 而 被 设置 成 hello ， 而 位 于 {{ with "world”}} 和 {{ end }} 之 

间 的 点 则 会 被 设置 成 world ; 但 是 ， 在 语句 {{ end }} 执行 完毕 之 后 ， 

点 的 值 又 会 重新 被 设置 成 hello ， 如 图 5-4 所 示 。 


eoe < 127.0.0.1:8080/process Č 由 


The dot is hello 






The dot is hello again 














图 5-4 ”使 用 设置 动作 对 点 〈. ) 进行 设置 


跟 迄 代 动 作 一 样 ， 设 置 动作 也 拥有 一 个 能 够 提供 备 选 方 案 的 变种 : 


{{ with arg }} 
Dot is set to arg 


{{ else }} 


Fallback if arg is empty 
{{ end }} 





代码 清单 5-8 展 示 了 这 一 变种 的 使 用 方法 。 


代码 清单 5-8 在 设置 点 的 时 候 提 供 备 选 方案 








«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
</head> 


«body» 
«div»The dot is (( . }}</div> 
«div» 
(( with "" jj 
Now the dot is set to (( . }} 
(( else jj 
The dot is still (( . )) 
(( end jj 
«/div» 
«div»The dot is (( . )) again«/div» 
«/body» 
</html> 





因为 传 给 with 动作 的 参数 为 空 字符 串 "" ， 上 所 以 模板 将 显示 {{ 
else }} 语句 之 后 的 内 容 ， 此 外 ， 因 为 with 动作 并 没有 修改 点 〈. ) 
的 值 ， 所 以 模板 打印 出 来 的 仍然 是 处 理 器 传 入 的 值 "hello”。 执 行 这 个 
新 模板 不 需要 对 处 理 器 或 者 服务 器 进行 任何 修改 ， 也 不 需要 重启 服务 
上 器， 只 要 刷新 一 下 浏览 器 ， 就 会 看 到 图 5-5 所 示 的 结果 。 


eoe < 127.0.0.1:8080/process ^ ü 


The dot is hello 






The dot is hello again 


图 5-5 在 设置 点 〈. ) 时 提供 备 选 方案 

















5.3.4 包含 动作 


包含 动作 (include action) 允许 用 户 在 一 个 模板 里 面包 含 妃 一 个 模 
板 ， 从 而 构建 出 验 套 的 模板 。 包 合 动 作 的 格式 为 {{ template "name" 
}} ， 其 中 name 参数 为 被 包含 模板 的 名 字 。 


代码 清单 5-9 展 示 了 一 个 使 用 包含 动作 的 例子 ， 在 这 个 例子 中 ， 模 
板 t1.html 包含 了 模板 t2.html 。 


代码 清单 5-9 ”模板 t1.html 





«IDOCTYPE html» 
«html lang="en"> 
«head» 
«meta charset-"utf-8"» 
«meta http-equiv-z"X-UA-Compatible" content-z"IE-z9"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«div» This is t1.html before«/div» 


«div»This is the value of the dot in ti1.html - [(( . ))]«/div» 
«hr/» 
(( template "t2.html" }} 
«hr/» 
«div» This is ti.html after«/div» 
«/body» 
</html> 





正如 代码 所 示 ， 模 板 文件 的 名 字 将 被 用 作 模板 的 名 字 。 记 住 ， 如 果 
用 户 在 创建 模板 的 时 候 没 有 为 模板 指定 名 字 ， 那 么 Go 语言 在 命名 模板 
时 将 沿用 模板 文件 的 名 字 及 扩展 名 。 














代码 清单 5-10 展 示 了 被 包含 的 模板 t2.html ， 这 个 模板 是 一 段 


HTML 代 人 码 片 段 。 

















代码 清单 5-10 ”模版 t2.html 











<div style="background-color: yellow;"> 
This is t2.html<br/> 


This is the value of the dot in t2.html - [{{ . }}] 
</div> 
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代码 清单 5-11 VH REIRI AAA 








func process(w http.ResponseWriter, r *http.Request) { 
t; := template.ParseFiles("ti1.html", "t2.html") 


t.Execute(w, "Hello World!") 


} 





跟 之 前 展示 的 代码 不 同 ， 在 执行 嵌 套 模板 时 ， 我 们 必须 对 涉及 的 所 
有 模板 文件 都 进行 语法 分 析 。 牢 记 这 一 反 是 非常 重要 的 ， 起 记 对 必要 的 
模板 文件 进行 语法 分 析 将 导致 程序 出 现 不 正确 的 结果 。 


因为 上 面 的 代码 并 没有 为 模板 设置 名 字 ， 所 以 模板 集合 中 的 模板 将 
沿用 模板 文件 的 名 字 。 正 如 之 前 所 说 ，ParseFiles 函数 的 第 一 个 参数 
是 具有 特殊 作用 的 : 在 进行 语法 分 析 时 ， 用 户 给 定 的 第 一 个 模板 文件 将 
成 为 主 模 板 (main template) ， 当 用 户 对 模板 集合 调用 Execute 方法 
时 ， 主 模板 将 被 执行 。 





图 5-6 展 示 了 服务 器 在 执行 上 述 模板 之 后 同 浏 览 右 返回 的 结果 。 


如 图 5-6 所 示 ， 模 板 t1.html 中 的 点 〈. ) 被 传 入 的 "Hello 


World!" 准确 无 误 地 替换 掉 了 ， 并 且 模 板 t2.html 的 内 容 也 出 现在 了 语 
句 {f{f template "t2.html”}} 所 在 的 位 置 。 因 为 模板 t1.html 并 没 
有 把 字符 串 "Hello world!" 也 传递 给 被 藤 套 的 模板 t2.html ， 所 以 
t2.html 中 的 点 的 打印 结果 为 空 字符 串 。 为 了 向 被 腐 套 的 模板 传递 数 
据 ， 用 户 可 以 使 用 包含 动作 的 变种 {{ template "name" arg }}, 其 
中 arg 就 是 用 户 想 要 传递 给 被 府 套 模板 的 数据 ， 代 码 清单 5-12 展 示 了 这 
个 变种 的 具体 使 用 方法 。 


eoo < 127.0.0.1:8080/process 


This is t1.html before 
This is the value of the dot in t1.html - [Hello World!] 


This is t1.html after 





图 5-6 HU ETUR 


代码 清单 5-12 ”通过 参数 将 模板 t1.html 中 的 数据 传递 给 被 嵌 套 的 模板 t2 .html 





«html» 
«head» 
«meta charset-"utf-8"» 
«meta http-equivz"X-UA-Compatible" content-z"IE-9"» 
«title»Go Web Programming«/title» 
«/head» 


«body» 
«div» This is ti.html before«/div» 
«div»This is the value of the dot in t1.html - [(( . ))]«/div» 
«hr/» 
(( template "t2.html" . }} 
«hr/» 
«div» This is ti1.html after«/div» 

«/body» 

«/html» 





这 个 模板 唯一 的 改动 就 是 在 t1.html 里 面 将 点 传递 给 了 t2 .html 。 
现在 ， 如 果 我 们 再 次 执行 这 个 模板 ， 它 将 产生 图 5-7 所 示 的 结 


eoe < 127.0.0.1:8080/process : 由 


This is t1.html before 
This is the value of the dot in t1.html - [Hello World!] 


This is t1.html after 


图 5-7 TB PS IR CCS ER 
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作 一 一 定义 动作 。 虽 然 使 用 动作 可 以 给 程序 员 带 来 方便 ， 但 是 本 市 介绍 
的 都 是 初级 的 模板 用 法 ， 它 们 并 不 能 最 大 限度 地 友 挥 模板 的 威力 。 为 了 





解决 这 个 问题 ， 本 章 接 下 来 将 介绍 参数 、 变 量 和 管道 等 高 级 模板 用 法 。 





5.4 参数、 变量 和 管道 


一 个 参数 (argument) 就 是 模板 中 的 一 个 值 。 它 可 以 是 布尔 值 、 整 
数 、 字 符 串 等 字面 量 ， 也 可 以 是 结构 、 结 构 中 的 一 个 字段 或 者 数组 中 的 
一 个 键 。 除 此 之 外 ， 参 数 还 可 以 是 一 个 变量 、 一 个 方法 (这 个 方法 必须 
只 返回 一 个 值 ， 或 者 只 返回 一 个 值 和 一 个 错误 ) 或 者 一 个 函数 。 最 后 ， 
参数 也 可 以 是 一 个 点 〈. ) ， 用 于 表示 处 理 器 问 模 板 引 擎 传递 的 数据 。 








比如 说 ， 在 以 下 这 个 例子 中 ，arg 是 一 个 参数 : 


(( if arg }} 


some content 


(( end jj 


除了 参数 之 外 ， 用 户 还 可 以 在 动作 中 设置 变量 。 变 量 以 美元 符号 
S) 开头 ， 束 像 这 样 : 





$variable := value 





初 看 上 去 ， 变 量 似乎 并 没有 什么 特别 大 的 用 处 ， 但 实际 上 它们 对 动 
作 来 说 是 非常 重要 的 。 作 为 例子 ， 以 下 代码 展示 了 怎样 使 用 变量 去 实现 
迭代 动作 的 一 个 变种 : 








(( range $key, $value : }} 
The key is {{ $key n me the value is {{ $value }} 
{{ end }} 


在 这 个 例子 中 ， 点 〈. ) 是 一 个 映射 ， 而 动作 range EKRAAN 
射 的 时 候 ， 会 将 变量 $key 和 $value 分 别 初始 化 为 当前 被 迭代 映射 元 素 
的 键 和 值 。 


模板 中 的 管道 〈pipeline) 是 多 个 有 序 地 串联 起 来 的 参数 、 函 数 和 
方法 ， 它 的 工作 方式 和 语法 跟 Unix 的 管道 也 非常 相似 : 


{{ pl | p2 | p3 }} 


这 里 的 pl1 p2 和 p3 可 以 是 参数 或 者 函数 。 管 道人 允许 用 户 将 一 个 参 
数 的 输出 传递 给 下 一 个 参数 ， 而 各 个 参数 之 间 则 使 用 | 分 隔 。 代 人 码 清 单 
5-13 展 示 了 一 个 管道 的 使 用 示例 。 




















代码 清单 5-13 ”模板 中 的 管道 














«IDOCTYPE html» 
«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 


«body» 
(( 12.3456 | printf "X.2f" )) 
«/body» 
</html> 

















为 了 更 好 地 显示 内 容 ， 用 户 经 常 需要 在 模板 中 对 数据 进行 格式 化 。 
比如 ， 在 代码 清单 5-13 所 示 的 例子 中 ， 我 们 想 要 在 显示 浮 点 数 的 时 候 只 
保留 两 位 小 数 精度 。 为 了 做 到 这 一 点 ， 我 们 可 以 使 用 fmt.Sprintf K 
数 或 者 模板 内 置 的 printf 函数 对 浮 点 数 进行 格式 化 〈 这 个 printf 函数 
实际 上 就 是 fmt.Sprintf 函数 的 别名 ) 。 


除 此 之 外 ， 我 们 还 通过 管道 将 数字 12 .3456 传递 给 了 printf K 
数 ， 并 在 printf 函数 的 第 一 个 参数 中 指定 了 格式 指示 符 〈specifier) ， 
最 终 ， 这 个 管道 将 返回 12.35 作为 结果 。 


虽然 管道 已 经 非常 强大 ， 但 它 还 不 是 模板 提供 的 最 为 强大 的 功能 
接 下 来 的 一 市 要 介绍 的 函数 才 是 。 


5.5 JA 


IEU AATE, Gorki n] HERR: Go 模板 引擎 内 置 
了 一 些 非常 基础 的 函数 ， 其 中 包括 为 fmt.Sprint 的 不 同 变种 创建 的 几 

个 别名 函数 《〈fmt 包 的 文档 详细 地 列 出 了 这 些 别 名 函数 ) ， 并 且 用 户 不 
a, 擎 内 置 的 函数 ， 还 可 以 自行 定义 目 己 想 要 的 函数 。 





需要 注意 的 是 ，Go 的 模板 引擎 函数 都 是 受 限 制 的 :尽管 这 些 函 数 
可 以 接受 任意 多 个 参数 作为 输入 ， 但 它们 只 能 返回 一 个 值 ， 或 者 返回 一 
个 值 和 一 个 错误 。 





为 了 创建 一 个 目 定 义 模 板 函 数 ， 用 户 需 要 


(1) 创建 一 个 名 为 FuncMap 的 映射 ， 并 将 映射 的 键 设 置 为 函数 的 
名 字 ， 而 映射 的 值 则 设置 为 实际 定义 的 函数 ; 


(2) 将 FuncMap 与 模板 进行 绑 定 。 


让 我 们 来 看 一 个 创建 自 定义 函数 的 具体 例子 。 在 编写 Web 应 用 的 时 
候 ， 用 户 常 常 需要 将 时 间 对 象 或 者 日 期 对 象 转换 为 ISO8601 格 式 的 时 间 


字符 串 或 者 日 期 字符 串 ， 又 或 者 将 ISO8601 格 式 的 字符 串 转 换 为 相应 的 
对 象 。 但 遗憾 的 是 ， HO cd MAL A 所 
以 我 们 就 再 要 像 代 码 清 单 5-14 展 示 的 那样 ， 目 行 创建 这 些 函 数 。 








代码 清单 5-14 ”创建 模板 自 定义 函数 





package main 


import ( 
"net/http" 
"html/template" 
"time" 


) 


func formatDate(t time.Time) string { 
layout :- "2006-01-02" 
return t.Format(layout) 

} 


func process(w http.ResponseWriter, r *http.Request) { 


funcMap := template.FuncMap { "fdate": formatDate } 
t := template.New("tmpl.html").Funcs(funcMap) 

t, _ = t.ParseFiles("tmpl.html") 

t.Execute(w, time.Now()) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 





这 上段 程序 首先 定义 了 一 个 名 为 formatDate 的 函数 ， 它 接受 一 
个 Time 结构 作为 输入 ， 然 后 以 “年 -月 -日 ”的 形式 返回 一 个 ISO8601 格 式 
的 字符 串 。 


在 之 后 的 处 理 器 中 ， 程 序 创建 了 一 个 变量 名 为 funcMap 的 FuncMap 


结构 ， 并 使 用 这 个 结构 将 名 字 fdate 映射 至 formatDate 函数 。 接 着 ， 
程序 使 用 template.New 函数 创建 了 一 个 名 为 tmpl.html 的 模板 。 
为 template.New 函数 会 返回 被 创建 的 模板 ， 所 以 程序 直接 以 串联 的 方 
式 调 用 模板 的 Funcs 方法 ， 并 将 前 面 创 建 的 funcMap 传递 给 模板 。 这 样 
—3K, funcMap 与 模板 的 绑 定 就 完成 了 了， 于 是 程序 接 下 来 陨 跟 往 利 一 
样 ， 对 模板 文件 tmp1.html 进行 语法 分 析 。 最 后 ， 程 序 调用 模板 的 
Execute 方法 ， 并 将 ResponseWriter 以 及 当前 时 间 传 递 给 它 。 





再 次 提醒 ， 在 调用 ParseFiles 函数 时 ， 如 果 用 户 没有 为 模板 文件 
中 的 模板 定义 名 字 ， 那 么 函数 将 使 用 模板 文件 的 名 字 作 为 模板 的 名 字 。 
与 此 同时 ， 在 调用 New 函数 创建 新 模板 的 时 候 ， 用 户 必 须 传 入 一 个 模板 
名 字 ， 如 果 用 户 给 定 的 模板 名 字 跟 前 面 分 析 模 板 时 通过 文件 名 提取 的 模 
板 名 字 不 相同 ， 那 么 程序 将 返回 一 个 错误 。 





在 看 过 了 处 理 器 的 相关 代码 之 后 ， 现 在 让 我 们 来 看 看 如 何 
在 tmpl.html 模板 中 使 用 前 面 定义 的 函数 ， 具 体 的 方法 如 代码 清单 5-15 
所 示 。 









































代码 清单 5-15 ”通过 管道 使 用 自 定义 函数 








«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 


«/head» 
«body» 
«div»The date/time is (( . | fdate ))«/div» 
«/body» 
«/html» 








用 户 可 以 通过 几 种 不 同 的 方式 使 用 目 定 义 函 数 。 比 如 ， 代 码 清 单 5- 
15 了 吏 展示 了 如 何 通 过 模板 的 管道 特性 ， 将 当前 时 间 由 管道 传递 全 fdate 
图 数 ， 并 籍 此 产生 图 5-8 所 示 的 输出 。 





eoe < 127.0.0.1:8080/process 4 由 


The date/time is 2015-02-08 


图 5-8 ”使 用 自 定义 函数 格式 化 日 期 或 时 间 














除 此 之 外 ， 我 们 也 可 以 像 调用 普通 函数 一 样 ， 将 点 〈. ) 作为 参数 
传递 给 fdate 函数 ， 有 具体 做 法 如 代码 清单 5-16 所 示 。 


代码 清单 5-16 ”通过 传递 参数 的 方式 使 用 自 定义 函数 





«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 


«body» 
«div»The date/time is (( fdate . ))«/div» 
«/body» 
«/html» 





以 上 两 种 调用 方式 会 产生 相同 的 结果 ， 但 使 用 管道 比 直接 调用 函数 
Vi EAD 如 果 用 户 定 义 了 多 个 函数 ， 那 么 他 就 可 以 通过 管道 
将 一 个 函数 的 输出 传递 给 为 一 个 函数 作为 输入 ， 从 而 以 不 iind 
s Zi. 尽管 普通 的 函数 调用 也 能 够 做 到 这 一 点 ， 但 使 用 管道 
以 产生 更 简单 且 更 可 读 的 代码 。 


5.6 上下文 感知 


Go 语言 的 模板 引擎 拥有 一 个 非常 有 趣 的 特性 一 一 它 可 以 根据 内 容 
所 处 的 上 下 文 改 变 其 显示 的 内 容 。 是 的 ， 你 没 看 错 。 根 据 内 容 在 文档 中 
所 处 的 位 置 ， 模 板 在 显示 这 些 内容 的 时 候 将 对 其 进行 相应 的 修改 ， 换 句 
in Go 的 模板 将 以 上 下 文 感知 (context-aware〉 的 方式 显示 内 容 。 那 
这 个 特性 有 什么 用 ， 我 们 又 会 在 什么 地 方 用 到 这 个 特性 呢 ? 





上 下 文 感知 的 一 个 显而易见 的 用 途 就 是 对 被 显示 的 内 容 实 施 正确 的 
转 义 〈escape) : 这 意味 着 ， 如 果 模 板 显示 的 是 HTML 格 式 的 内 容 ， 那 
么 模板 将 对 其 实施 HTML 转 义 ; 如 果 模 板 显示 的 是 JavaScript 格 式 的 内 
容 ， 那 么 模板 将 对 其 实施 JavaScript 转 义 ; 诸如 此 类 。 除 此 之 外 ，Go 模 
板 引 擎 还 可 以 识别 出 内 容 中 的 URL 或 者 CSS 样 式 。 代 码 清 单 5-17 展 示 了 
一 个 上 下 文 感知 特性 的 使 用 例子 。 



































代码 清单 5-17 为 了 展示 模板 中 的 上 下 文 感知 特性 而 设置 的 处 理 器 

















package main 


import ( 
"net/http" 
"html/template" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
t,  :- template.ParseFiles("tmpl.html") 
content := `I asked: «i»"What's up?"«/i»' 
t.Execute(w, content) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/process", process) 
server.ListenAndServe() 





这 个 处 理 器 同 模板 发 送 了 文本 字符 串 I asked: «i»"What's up?" 
</i> ， 它 包含 了 几 个 需要 事先 转 义 的 特殊 字符 ， 代 码 清单 5-18 展 示 了 
与 这 个 处 理 器 相对 应 的 模板 文件 tmp1.html 。 














代码 清 





5-18 ”上下文 感知 模板 











«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«div»(( . ))«/div» 


«div»«a hrefz"/(( . ))"»Path«/a»«/div» 
«div»«a href-"/?q-(( . jJ)" »Query«/a»«/div» 
«div»«a onclick-"f('(( . ))')"»Onclick«/a»«/div» 
«/body» 
«/html» 





正如 代码 所 示 ， 这 个 模板 将 传 入 的 参数 放 到 了 HTML 中 的 多 个 不 同 
的 位 置 ， 并 且 每 个 位 置 都 使 用 了 <div> 标签 对 其 进行 包 庄 。 如 果 我 们 使 
用 4.1.4 节 介绍 的 方法 ， 通 过 cURL 获取 未 经 改动 的 原始 HTML 文 件 ， 那 
么 我 们 将 得 到 以 下 结果 : 





curl -i 127.0.0.1:8080/process 
HTTP/1.1 200 OK 

Date: Sat, 07 Feb 2015 05:42:41 GMT 
Content-Length: 505 

Content-Type: text/html; charset-utf-8 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«div»I asked: &lt;i&gt;8434;What&4s39;s up?8434;81t;/i&gt;«/div» 
«div» 
«a href="/I%20asked:%20%3ci%3e%22What%27s%20up?%22%3c/i%3e"> 
Path 
«/a» 
</div> 
<div> 
«a href="/?q=I1%20asked%3a%20%3ci%3e%22What%27s%20up%3f%22%3c%2fi%3e" 


Query 
</a> 
</div> 
<div> 
<a onclick="f('I asked: \x3ci\x3e\x22What\x27s up?\x22\x3c\/i\x3e')" 


Onclick 
</a> 
</div> 
</body> 
</html> 





y 


这 个 结果 看 上 去 有 点 儿 复 杂 ， 表 5-1 展 示 了 结果 HTML 与 输入 原文 之 
间 的 区 别 。 














表 5-1 ”Go 模板 中 的 上 下 文 感知 : 根据 动作 所 在 的 位 置 ， 同 样 的 内 容 输入 将 产生 不 同 的 输出 结 
ES 























I asked: «i»"What's up?"«/i» 


原 文 本 
TW a Jus I asked: &lt;i&gt;&434;What&439;s up?&#34;&lt;/i&gt; 





«a hrefz"/(( . ) I%20asked:%20%3ci%3e%22What%27s%20up?%22%3c/i%3e 


)'» 
«a hrefz"/?q-(( . }}"> I%20asked%3a%20%3ci%3e%22What%27s%20up%3f%22%3c%2fi%3e 
«a onclick="{{ . }}"> I asked: \x3ci\x3e\x22What\x27s up?\x22\x3c\/i\x3e 


上 下 文 感知 特性 主要 用 于 实现 自动 的 防御 编程 ， 并 且 它 使 用 起 来 非 
第 方便 。 通 过 根据 上 下 文 对 内 容 进行 修改 ，Go 模 板 可 以 防止 某 些 明显 
并 且 低 级 的 编程 错误 。 比 如 ， 接 下 来 的 内 容 就 会 问 我 们 展示 如 何 使 用 上 
下 文 感知 特性 来 防御 XSS (cross-site scripting， 跨 站 脚本 ) 攻击 。 








5.6.1 ”防御 XSS 攻 击 


持久 性 XSS 漏 洞 (persistent XSS vulnerability〉 是 一 种 常见 的 XSS 攻 
击 方式 ， 这 种 攻击 是 由 于 服务 器 将 攻击 者 存储 的 数据 原原本本 地 显示 给 
其 他 用 户 所 致 的 。 举 个 例子 ， 如 果 有 一 个 存在 持久 性 XSS 漏 洞 的 论坛 ， 
它 允 许 用 户 在 论坛 上 面 发 布 帖子 或 者 回复 ， 并 且 其 他 用 户 也 可 以 阅读 这 
些 帖 子 以 及 回复 ， 那 么 攻击 者 就 可 能 会 在 他 发 布 的 内 容 中 引入 市 
fi«script» 标签 的 代码 。 因 为 论坛 即使 在 内 容 带 有 <script> 标签 的 
情况 下 ， 仍 然 会 原原本本 地 同 用 户 显 示 这 些 内 容 ， 所 以 用 户 将 在 晤 不 知 
情 的 情况 下 ， 使 用 自己 的 权限 去 执行 攻击 者 发 布 的 恶意 代码 。 预 防 这 一 
攻击 的 常见 方法 就 是 在 显示 或 者 存储 用 户 传 入 的 数据 之 前 ， 对 数据 进行 




















转 义 。 但 正如 很 多 漏洞 以 及 bug 一 样 ， 持 久 性 XSS 漏 洞 往往 会 由 于 人 为 
的 因素 而 出 现 。 


为 了 说 明 如 何 防御 持久 性 XSS 漏 洞 ， 我 们 需要 用 到 一 些 HTML 表 单 
数据 。 这 一 次 ， 比 起 直接 将 数据 硬 编码 到 处 理 器 里 面 ， 更 好 的 选择 是 使 
用 第 4 章 学 到 的 HIML 表 单 知 识 ， 创 建 一 个 代码 清单 5-19 所 示 的 HIML 表 
单 。 这 个 表单 允许 我 们 向 Web 应 用 发 送 数据 ， 并 将 其 存储 在 form .html 
文件 中 。 

















代码 清单 5-19 用 于 实施 XSS 攻 击 的 表单 














«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
«form actionz"/process" method-"post"» 


Comment: «input name-"comment" type="text"> 
«hr/» 
«button id-"submit"»Submit«/button» 
«/form» 
«/body» 
«/html» 





接着 ， 为 了 处 理 来 自 HTML 表 单 的 数据 ， 我 们 需要 对 人 处理 器 做 相应 
的 修改 ， 如 代码 清单 5-20 所 示 。 


代码 清单 5-20 ”测试 XSS 攻 击 








package main 


import ( 
"net/http" 
"html/template" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
t,  :- template.ParseFiles("tmpl.html") 
t.Execute(w, r.FormValue("comment")) 


} 


func form(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("form.html") 
t.Execute(w, nil) 


} 


func main() { 
server := http.Server( 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
http.HandleFunc("/form", form) 
server.ListenAndServe() 








最 后 ， 为 了 让 XSS 攻 击 的 测试 结果 可 以 更 好 地 显示 出 来 ， 我 们 需要 
修改 tmp1.html 模板 文件 ， 如 代码 清单 5-21 所 示 。 








代码 清单 5-21 修改 后 的 tmp1.html 模板 














«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 


«body» 
«div»(( . ))«/div» 
«/body» 
«/html» 





现在 ， 编 译 并 启动 修改 后 的 服务 器 ， 然 后 访问 
http://127.0.0.1:8080/form。 接 着 像 图 5-9 所 示 的 那样 ， 将 以 下 内 容 输 入 到 
表单 的 文本 框 里 面 ， 然 后 按 下 Submit 按 钮 : 


«script»alert('Pwnd!');«/script» 


对 于 那些 不 过 滤 用 户 输入 并 且 在 Web 页 面 上 直接 显示 用 户 输入 的 模 
板 引 擎 来 说 ， 执 行 图 5-9 所 示 的 操作 将 会 显示 一 条 提示 信息 ， 这 也 意味 
着 攻击 者 可 以 让 网 站 上 的 其 他 用 户 执行 任意 可 能 的 攻击 代码 。 与 此 相 
反 ， 正 如 我 们 之 前 提 到 的 那样 ， 即 使 程序 员 忘 了 对 用 户 的 输入 进行 过 
滤 ，Go 的 模板 引擎 也 会 在 显示 用 户 输入 时 将 其 转换 为 转 义 之 后 的 
HTML， 以 此 来 避免 可 能 会 出 现 的 问题 ， 图 5-10 证 实 了 这 一 点 。 





eoo < > 127.0.0.1:8080/form > 由 
Comment: «script»alert(Pwnd! );«/script» 


Submit 


图 5-9 ”用 于 实施 XSS 攻 击 的 表单 


eoe < 127.0.0.1:8080/process 


«scripoalert( Pwnd!);«/scripc» 


图 5-10 ”多谢 Go 的 模板 引擎 ， 原 本 会 导致 漏洞 的 用 户 输入 已 经 被 转 义 了 
查看 这 个 页 面 的 源 代码 将 会 看 到 以 下 结果 : 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»GoWebProgramming«/title» 
«/head» 


«body» 
«div»&lt;script&gt;alert(&439;Pwnd!81439;);&lt;/script&gt;«/div» 
«/body» 
</html> 





上 下 文 感知 功能 不 仅 能 够 自动 对 HTML 进 行 转 义 ， 它 还 能 够 防止 基 
于 JavaScript、CSS 甚 至 URL 的 XSS 攻 击 。 那 么 这 是 否 意味 着 我 们 只 要 使 
用 Go 的 模板 引擎 就 可 以 无 忧 无 虑 地 进行 开发 了 呢 ? 并 非 如 此 ， 上 下 文 
感知 虽然 很 方便 ， 但 它 并 非 灵 丹 妙 药 ， 而 且 有 不 少 方法 可 以 绕 开 上 下 文 
感知 。 实 际 上 ， 如 果 需 要 ， 用 户 是 可 以 完全 不 使 用 上 下 文 感知 特性 的 。 


5.6.2 ”不 对 HTMEL 进行 转 义 


如 果真 的 想 要 允许 用 户 输入 HTML 代码 或 者 JavaScript 人 代码， 并 在 显 
示 内 容 时 执行 这 些 代码 ， 可 以 使 用 Go 提供 的 “不 转 义 HTML” 机 制 : 只 要 
把 不 想 被 转 义 的 内 容 传 给 template.HTML 函数 ， 模 板 引擎 就 不 会 对 其 
进行 转 义 。 作 为 例子 ， 让 我 们 对 之 前 展示 过 的 处 理 器 做 一 些小 修改 : 








func proceso n http.ResponseWriter, r *http.Request) { 
t,  :- template.ParseFiles("tmpl.html") 


t. Ex&cuti (uw, template.HTML(r.FormValue("comment"))) 
j 





注意 ， 在 这 个 修改 后 的 处 理 器 函数 中 ， 程 序 通过 类 型 转换 
(typecast) 将 表单 中 的 评论 值 转换 成 了 template.HTML 类 型 。 


现在 ， 重 新 编译 并 运行 这 个 服务 器 ， 然 后 再 次 尝试 实施 XSS 攻 击 。 
攻击 产生 的 结果 将 根据 用 户 使 用 的 浏览 器 而 定 ， 如 果 用 户 使 用 的 是 
Chrome、Safari、IE8 或 以 上 版 本 的 正 浏 览 器 ， 那 么 什么 都 不 会 发 生 一 一 
用 户 将 看 到 一 个 空 昌 的 页 面 ; 但 如 果 用 户 使 用 的 是 Firefox， 那 么 用 户 将 
会 看 到 图 5-11 所 示 的 画面 。 


因为 于、Chrome 和 Safari 在 默认 情况 下 都 能 够 防御 某 些 特定 类 型 的 
XSS 攻 击 ， 所 以 我 们 的 XSS 攻 击 在 这 3 个 浏览 器 上 都 没有 能 够 成 功 实 施 ; 
与 此 相反 ， 因 为 Firefox 并 不 具备 内 置 的 XSS 防 御 功 能 ， 所 以 我 们 在 
Firefox 浏 览 器 上 成 功 实 施 了 XSS 攻 击 。 


在 需要 时 ， 用 户 也 可 以 通过 发 送 一 个 最 初 由 微软 公司 为 正 浏 览 器 创 
建 的 特殊 HTTP 响应 首部 XXXSS-Protection 来 让 浏览 器 关闭 内 置 的 XSS 防 
御 功 能 ， 就 像 这 样 : 


func process(w http.ResponseWriter, r *http.Request) { 


w.Header().Set("X-XSS-Protection", "6") 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, template.HTML(r.FormValue("comment"))) 





Transferring data from 127.0.0.1... 


图 5-11 XSS 攻 击 成 功 


现在 ， 如 果 再 次 尝试 实 施 XSS 攻 击 ， 那 么 你 将 会 在 下 、Chrome 和 
Safari 上 看 到 与 Firefox 相 同 的 攻击 效果 。 


5.7 WERI 


本 章 到 目前 为 止 已 经 介绍 了 Go 模板 引擎 的 不 少 特性 ， 在 继续 了 解 
更 多 特性 之 前 ， 我 们 需要 先 学 习 一 下 如 何在 Web 应 用 中 使 用 布局 。 








所 谓 的 布局 〈layout) ， 指 的 是 web 设 计 中 可 以 重复 应 用 在 多 个 页 
面 上 的 固定 模式 。 为 了 构建 协调 一 致 的 用 户 界 面 ，Web 应 用 第 常 需要 展 
示 一 些 相 似 的 页 面 ， 因 此 Web 应 用 也 会 经 常用 到 布局 。 比 如 说 ， 很 多 
Web 应 用 都 拥有 相应 的 涉 部 菜单 ， 以 及 提供 服务 器 状态 、 版 权 声 明 、 联 
系 方式 等 附加 信息 的 尾部 栏 ， 而 其 他 一 些 Web 应 用 可 能 会 在 屏幕 的 左 侧 
提供 导航 栏 又 或 者 多 级 导航 染 单 。 不 难 猜 出 ， 这 些 布局 实际 上 都 可 以 使 
H RERIK. 








BHATE E ATE a EHE EEKE, (BEH X 
种 方法 来 开发 复杂 的 Web 应 用 ， 不 仅 需 要 将 大 量 代码 便 编码 到 处 理 器 里 
面 ， 还 需要 创建 大 量 的 模板 文件 ， 而 引发 这 一 问题 的 原因 跟 我 们 使 用 模 
板 的 方式 有 关 。 


正如 之 前 所 说 ， 我 们 可 以 通过 包含 动作 ， 在 一 个 模板 里 面包 含 男 一 
个 模板 : 


{{ template "name" . }} 


其 中 动作 的 参数 name 残 是 被 包含 模板 的 名 字 ， 并 且 这 个 名 字 还 是 一 个 
字符 串 冲 量 。 这 意味 者 如 果 我 们 继续 像 之 前 一 样 ， 使 用 文件 名 作为 模板 
名 ， 那 么 因为 每 个 页 面 都 拥有 它们 各 目的 布局 模板 文件 ， 所 以 程序 最 终 
将 无 法 拥有 任何 可 共用 的 公共 布局 ， 而 这 种 做 法 跟 构 建 布局 的 想法 正好 
是 相 背 的 。 比 如 说 ， 对 于 代码 清单 5-22 所 示 的 模板 文件 ， 我 们 就 不 能 把 
它 用 作 公 共 的 布局 模板 文件 。 














代码 清单 5-22 ”无 效 的 模板 布局 文件 


«html» 





«head» 


«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
(( template "content.html" }} 
«/body» 
«/html» 





出 现 这 种 问题 的 根源 在 于 我 们 实际 上 并 没有 以 正确 的 方式 使 用 Go 
模板 引擎 。 尽 管 我 们 可 以 让 每 个 模板 文件 都 只 定义 一 个 模板 ， 并 将 模板 
文件 的 名 字 用 作 模 板 的 名 字 ， 但 实际 上 ， 我 们 也 可 以 通过 定义 动作 
(define action) ， 在 模板 文件 里 面 显 式 地 定义 模板 ， 吏 像 代码 清单 5-23 
所 示 的 那样 。 








代码 清单 5-23” 显 式 地 定义 一 个 模板 





{{ define "layout" }} 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
(( template "content" }} 
«/body» 
«/html» 


(( end jj 





这 个 文件 以 一 个 {{ define "layout" Y) 标签 作 开 头 ， 并 以 一 个 
{{ end }} 标签 结尾 ， 而 介 于 这 两 个 标签 之 间 的 内 容 束 是 layout 模板 
的 定义 。 与 此 同时 ， 通 过 使 用 另 一 个 定义 动作 ， 我 们 还 可 以 在 这 个 文件 
里 面 再 多 创建 一 个 模板 。 换 句 话 说， 我 们 可 以 像 代 码 清单 5-24 所 示 的 那 








样 ， 在 同一 个 模板 文件 里 面 定义 多 个 不 同 的 模板 。 














代码 清单 5-24 在 一 个 模板 文件 
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(( define "layout" }} 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 
(( template "content" }} 
«/body» 
«/html» 


(( end jj 
(( define "content" }} 


Hello World! 


(( end jj 





代码 清单 5-25 展 示 了 处 理 吉 使 用 这 些 模板 的 方法 。 


代码 清单 5-25 “使 用 显 式 定义 的 模板 





func process(w http.ResponseWriter, r *http.Request) { 
t,  :- template.ParseFiles("layout.html") 


t.ExecuteTemplate(w, "layout", "") 
} 














分 析 模 板 的 方法 跟 之 前 介绍 过 的 一 样 ， 但 是 这 次 在 执行 模板 的 时 
修 ， 程 序 需要 显 式 地 使 用 ExecuteTemplate 方法 ， 并 把 待 执 行 的 
layout 模板 的 名 字 用 作 方 法 的 第 二 个 参数 。 因 为 layout ERRE T 
content 模板 ， 所 以 程序 只 需要 执行 ]ayout 模板 就 可 以 在 浏览 器 中 得 


到 content 模板 产生 的 Hello world! 输出 了 。 通 过 使 用 cURL 获取 模 
板 输出 的 实际 HTML 文 件 ， 我 们 将 看 到 以 下 结果 : 


> curl -i http://127.0.0.1:8080/process 
HTTP/1.1 266 OK 

Date: Sun, 08 Feb 2015 14:09:15 GMT 
Content-Length: 187 

Content-Type: text/html; charset-utf-8 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
«title»Go Web Programming«/title» 
«/head» 
«body» 


Hello World! 


«/body» 
</html> 





用 户 除 可 以 在 同一 个 模板 文件 里 面 定 义 多 个 不 同 的 模板 之 外 ， 还 可 
以 在 不 同 的 模板 文件 里 面 定义 同名 的 模板 。 作 为 例子 ， 让 我 们 首先 移 
除 1ayout .html 文件 中 现 有 的 content 模板 定义 ， 然 后 分 别 在 代码 清 
单 5-26 和 代码 清单 5-27 所 示 的 red_hello.html 文件 和 
blue hello.html 文件 中 重新 定义 content 模板 。 


























代码 清单 5-26 red hello.html 


(( define "content" }} 


«h1 style="color: red;"»Hello World!«/hi» 


(( end jj 

















代码 清单 5-27 blue hello.html 














(( define "content" }} 


«h1 style="color: blue;"»Hello World!«/h1» 


(( end jj 





代码 清单 5-28 展 示 了 修改 之 后 的 处 理 器 ， 它 向 我 们 演示 了 应 该 如 何 
使 用 在 不 同 模板 文件 中 定义 的 两 个 content 模板 。 



































代码 清单 5-28 ”处 理 器 使 用 在 不 同 模 板 文件 中 定义 的 同名 模板 


func process(w http.ResponseWriter, r *http.Request) { 
rand.Seed(time.Now().Unix()) 
var t *template.Template 
if rand.Intn(10) > 5 { 
t, _ = template.ParseFiles("layout.html", "red hello.html") 
) else { 


t, _ = template.ParseFiles("layout.html", "blue hello.html") 


} 
t.ExecuteTemplate(w, "layout", "") 





这 个 处 理 器 会 根据 生成 的 随机 数 ， 决 定 对 red_hello.html 和 
blue_hello.html 这 两 个 模板 文件 中 的 哪 一 个 进行 语法 分 析 。 当 人 处理 
器 像 之 前 一 样 执行 包含 了 content fli] Layout 模板 时 ， 被 随机 选中 
的 那个 模板 文件 中 定义 的 content 模板 就 会 被 执行 。 

Jjred hello.html 和 blue_hello.html 这 两 个 模板 文件 都 定义 了 
content 模板 ， 所 以 它们 中 的 哪 一 个 被 随机 选中 了 进行 语法 分 析 ， 被 分 
析 文 件 中 定义 的 content 模板 就 会 被 执行 。 换 句 话 说， 我们 可 以 在 维 
持 “layout 模板 包含 content 模板 ”这 一 关系 不 变 的 情况 下 ， 通 过 对 不 
同 的 模板 文件 进行 语法 分 析 来 达到 改变 输出 结果 的 目的 。 


现在 ， 如 果 我 们 重新 编译 并 启动 修改 后 的 服务 占 ， 然 后 通过 浏览 器 
对 其 进行 访问 ， 那 么 我 们 将 会 随机 看 到 次 色 或 者 红色 的 Hello World! 
输出 ， 就 像 图 5-12 所 示 的 那样 。 


eoe < 127.0.0.1:8080/process : 由 


Hello World! 





图 5-12 能 够 随机 切换 内 容 的 模板 
5.8 ”通过 块 动作 定义 默认 模板 


Go 1.6 引 入 了 一 个 新 的 块 动作 (block action) ， 这 个 动作 允许 用 户 
定义 一 个 模板 并 且 立 即使 用 。 块 动作 看 上 去 是 下 面 这 个 样子 的 : 
{{ block arg }} 


Dot is set to arg 


{{ end }} 


为 了 更 好 地 了 解 块 动作 的 使 用 方法 ， 我 们 将 使 用 块 动作 重新 实现 上 
一 节 展 示 过 的 例子 ， 并 在 处 理 器 没有 指定 特定 的 模板 时 ， 默 认 展示 蓝 色 





的 Hello World 模 板 。 代 码 清单 5-29 展 示 了 修改 之 后 的 处 理 器 ， 正 如 加 粗 
的 代码 行 所 示 ， 处 理 器 的 else 块 将 不 再 同时 分 析 layout .html 文件 和 
blue hello.html 文件 ， 而 是 只 分 析 Layout .html 文件 。 








代码 清单 5-29 只 对 1ayout.html 进行 语法 分 析 





func process(w http.ResponseWriter, r *http.Request) { 
rand.Seed(time.Now().Unix()) 
var t *template.Template 
if rand.Intn(10) > 5 { 
t,  - template.ParseFiles("layout.html", "red hello.html") 
) else { 


t,  - template.ParseFiles("layout.html") 


} 
t.ExecuteTemplate(w, "layout", "") 





如 采 我 们 现在 就 重新 编译 并 局 动 服务 器 ， 那 么 服务 器 就 会 因为 
Eelse 块 中 找 不 到 需要 进行 语法 分 析 的 content 模板 而 出 现 随机 骨 误 
的 情况 。 为 了 解决 这 个 问题 ， 我 们 需要 像 代码 清单 5-30 所 示 的 那样 ， 
在 1ayout .html 模板 文件 中 通过 块 动作 定义 content 模板 ， 并 将 其 用 
作 默 认 的 content 模板 。 























5-30 ”通过 块 动作 添加 默认 的 content 模板 





代码 清 上 























(( define "layout" }} 


< html» 
< head» 
< meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
« title»Go Web Programming« /title» 
« /head» 
< body» 
(( block "content" . jj 


< h1 style="color: blue;"»Hello World!« /h1> 


(4 end }} 


« /body» 
« /html» 


(( end jj 





块 动作 能 够 高 效 地 定义 一 个 content 模板 ， 并 将 它 放 置 到 layout 
模板 里 面 。 当 layout 模板 被 执行 时 ， 如 果 模 板 引 擎 没有 找到 可 用 的 
content 模板 ， 那 么 它 束 会 使 用 块 动作 中 定义 的 content 模板 。 


在 最 近 的 这 几 章 ， 我 们 学 习 了 如 何 接收 请 求 ， 如 何 处 理 请 求 ， 以 及 
如 何 生成 用 于 啊 应 请 求 的 内 容 ， 而 在 接 下 来 的 一 章 ， 我 们 将 要 学 习 如 何 
通过 Go 语言 将 数据 存储 到 内 存 、 文 件 或 者 数据 库 里 面 。 


5.9 ”小 结 


。 在 Web 应 用 中 ， 模 板 引 擎 会 把 模板 和 数据 进行 合并 ， 生 成 将 要 返回 
给 客户 端的 HTML 。 

Go 的 标准 模板 引擎 定义 在 html/template 包 当 中 。 

Go 模板 引擎 的 工作 方式 就 是 对 一 个 模板 进行 语法 分 析 ， 接 着 在 执 
行 这 个 模板 的 时 候 ， 将 一 个 ResponseWriter 以 及 一 些 数据 传递 给 
它 。 被 调用 的 模板 引擎 会 对 传 入 的 已 分 析 模 板 以 及 数据 进行 合并 ， 
然后 把 合并 的 结果 传递 给 ResponseWriter 。 

e G0 的 模板 拥有 一 系列 丰富 多 样 并 且 威 力 强大 的 动作 ， 这 些 动 作 就 





一 系列 命令 ， 它 们 可 以 告诉 模板 应 该 以 何 种 方式 与 数据 合并 。 

S RISLA. MERNDERÉ 数 、 管 道 和 变量 : 其 中 参数 用 于 
表示 模板 中 的 数据 值 ， 省 道 用 于 串联 起 多 个 参数 和 函数 ， 至 于 变量 
A 

。 Go 拥有 一 系列 受 限 的 模板 函数 。 此 外 ， 通 过 创建 一 个 函数 映射 并 
将 它 与 模板 进行 绑 定 ， 用 户 也 可 以 创建 出 自己 的 模板 函数 。 

。 Go 的 模板 引擎 可 以 根据 数据 所 在 的 位 置 改 变数 据 的 显示 方式 ， 这 
种 上 下 文 感知 特性 能 够 有 效 地 防御 XSS 攻 击 。 

。 人们 在 设计 一 个 拥有 一 致 外 观 和 使 用 感受 的 Web 应 用 时 ， 常 常会 用 
到 Web 布 局 ，Go 可 以 使 用 舱 套 模板 来 实现 Web 布 局 。 











HOR ”存储 数据 


本 章 主要 内 容 


e 使 用 结构 进行 内 存 存 储 

。 使 用 CSV 和 和 gob 二进制 文件 进行 文件 存储 
。 使 用 SQL 进 行 关系 数据 库存 储 

。 Go 与 SQL 映射 器 








本 书 在 第 2 章 引入 了 数据 持久 化 这 一 概念 ， 并 简单 地 介绍 了 如 何 将 
数据 持久 化 到 PostgreSQL 这 个 关系 数据 库 中 。 本 章 将 会 继续 深入 讨论 数 
据 持久 化 这 一 主题 ， 并 说 明 如 何 才 能 将 数据 存储 到 内 存 、 文 件 、 关 系数 
据 库 以 及 NoSQL 数 据 库 中 。 





尽 绾 数据 持久 化 从 技术 上 来 说 并 不 属于 Web 应 用 编程 的 范畴 ， 但 因 
为 绝 大 部 分 Web 应 用 都 会 以 东 种 形式 存储 数据 ， 所 以 数据 持久 化 是 除了 
模板 和 处 理 需 这 两 大 文 柱 之 外 ， 任 何 Web 应 用 都 必 不 可 少 的 第 三 大 文 
RB. 


Web 应 用 通常 会 采取 以 下 手段 存储 数据 : 


o 在 程序 运行 时 ， 将 数据 存储 到 内 存 里 面 ; 
。 将 数据 存储 到 文件 系统 的 文件 里 面 ; 
o 通过 服务 器 程序 前 跨 ， 将 数据 存储 到 数据 库 里 面 。 


在 本 章 中 ， 我 们 将 会 分 别 通过 以 上 这 3 种 手段 ， 使 用 Go 对 数据 进行 


访问 ， 并 对 数据 执行 俗称 CRUD 的 创建 、 获 取 、 更 新 和 删除 这 4 个 操 
作 。 


61 内 存 存储 











本 节 所 说 的 内 存 存储 指 的 是 将 数据 存储 在 运行 中 的 应 用 里 面 ， 并 在 
应 用 运行 的 过 程 中 使 用 这 些 数 据 ， 而 不 是 说 将 数据 存储 到 内 存 数据 库 里 
面 。 将 数据 存储 在 数据 结构 里 面 是 实现 内 存 存储 的 常见 手段 ， 对 于 Go 
语言 来 说 ， 这 意味 着 使 用 数组 、 切 片 、 映 射 和 结构 来 存储 数据 。 





存储 数据 这 一 操作 本 时 是 非常 简单 的 ， 用 户 只 需要 创建 相应 的 结 
构 、 切 片 和 映射 束 可 以 了 。 但 如 果 我 们 更 加 深入 地 思考 这 个 问题 就 会 发 
现 ， 程 序 最 终 操作 的 将 不 是 一 个 个 单独 的 结构 ， 而 是 一 系列 由 容器 
(container) ARMEA: 这 些 容 器 既 可 以 是 数组 、 切 片 和 映射 ， 
也 可 以 是 栈 、 树 、 队 列 以 及 其 他 任意 类 型 的 数据 结构 。 


除 容 露 本身 之 外 ， 如 何 从 容 需 里 面 获取 所 需 的 数据 也 是 一 个 非常 有 
趣 的 问题 。 比 如 说 ， 代 码 清 单 6-1 惑 展示 了 一 个 使 用 映射 作为 结构 容器 
的 例子 。 














代码 清单 6-1 在 内 存 里 面 存储 数据 














package main 


import ( 
"n fmt " 
) 


type Post struct ( 
Id int 
Content string 
Author string 


} 


var PostById map[int]*Post 
var PostsByAuthor map[string][]*Post 


func store(post Post) ( 
PostById[post.Id] = &post 
PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], &post) 


} 
func main() { 


PostById = make(map[int]*Post) 
PostsByAuthor = make(map[string][]*Post) 


post1 := Post{Id: 
post2 := Post{Id: 
post3 := Post{Id: 
post4 := Post{Id: 
w"Sau Sheong"} 
store(post1) 
store(post2) 
store(post3) 
store(post4) 


， Content: "Hello World!", Author: "Sau Sheong"} 
， Content: "Bonjour Monde!", Author: "Pierre") 

, Content: "Hola Mundo!", Author: "Pedro") 

, Content: "Greetings Earthlings!", Author: 


AUNE 


fmt.Println(PostById[1]) 
fmt.Println(PostById[2]) 


for , post := range PostsByAuthor["Sau Sheong"] { 
fmt.Println(post) 

j 

for _, post := range PostsByAuthor["Pedro"] { 
fmt.Println(post) 


} 








这 个 程序 会 使 用 Post 结构 来 表示 论坛 应 用 中 的 帖子 ， 并 将 该 结构 








存储 在 内 存 里 面 : 





type Post struct ( 
Id int 
Content string 
Author string 


[L CR 


Post 结构 中 最 主要 的 数据 是 帖子 的 内 容 ， 用 户 也 可 以 通过 帖子 的 
唯一 JD 或 者 帖子 作者 的 名 字 来 获取 帖子 。 程 序 会 通过 将 一 个 代表 帖子 的 
键 映 冉 至 实际 的 Post 结构 来 存储 多 个 帖子 。 为 了 提供 两 种 不 同 的 方法 
来 访问 帖子 ， 程 序 分 别 使 用 了 两 个 map 来 创建 两 种 不 同 的 映射 : 


var PostById map[int]*Post 
var PostsByAuthor map[string][]*Post 


程序 使 用 了 两 个 变量 来 存储 映射 ， 其 中 PostById 变量 会 将 帖子 的 
唯一 ID 映射 至 指向 帖子 的 指针 ， 而 PostsByAuthor 变量 则 会 将 作者 的 
名 字 映 射 人 至 一 个 切 厂 ， 这 个 切 厂 可 以 包含 多 个 指 同 帖子 的 指针 。 注 意 ， 
无 论 是 PostById 还 是 PostsByAuthor ， 它 们 映射 的 都 是 指向 帖子 的 指 
针 而 不 是 帖子 本 身 。 这 样 做 可 以 确保 程序 无 论 是 通过 ID 还 是 通过 作者 的 
名 字 来 获取 帖子 ， 得 到 的 都 是 相同 的 帖子 ， 而 不 是 同一 帖子 的 不 同 副 
A. 

















在 此 之 后 ， 程 序 定义 了 用 于 存储 帖子 的 store 函数 : 


func store(post Post) ( 
PostById[post.Id] = &post 


PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], &post) 
j 





store 函数 会 将 一 个 指 癌 帖子 的 指针 分 别 存 储 到 PostById 变量 和 
PostsByAuthor 变量 里 面 。 紧 接着 ， 在 main() KAEM, FEE T 
多 个 将 要 被 存储 的 帖子 ， 这 个 过 程 唯一 要 做 的 就 是 创建 多 个 Post 结构 
的 实例 : 


Post{Id : Content: "Hello World!", Author: "Sau Sheong") 
Post(Id: Content: "Bonjour Monde!", Author: "Pierre" 

Post(Id: Content: "Hola Mundo!", Author: "Pedro") 

Post{Id : Content: "Greetings Earthlings!", Author: "Sau Sheong 





接着 程序 会 调用 前 面 定 义 的 store 函数 ， 把 这 些 帖子 一 一 存储 起 


store(post1) 
store(post2) 
store(post3) 
store(post4) 





如 果 运 行 这 个 程序 ， 我 们 将 会 看 到 以 下 输出 : 


&(1 Hello World! Sau Sheong) 
&(2 Bonjour Monde! Pierre) 
&(1 Hello World! Sau Sheong) 


&(4 Greetings Earthlings! Sau Sheong) 
&(3 Hola Mundo! Pedro) 








注意 ， 无 论 程序 是 通过 帖子 的 ID 还 是 帖子 的 作者 获取 帖子 ， 最 终 得 
到 的 都 是 同一 个 帖子 。 





这 个 例子 看 上 去 非常 简单 直接 ， 甚 至 可 以 说 有 点 儿 简 单 过 头 了 。 我 
们 之 所 以 要 学 习 怎 样 将 数据 存储 在 内 存 里 面 ， 是 因为 人 们 在 构建 Web 应 
用 的 时 候 ， 负 第 会 像 第 2 章 展 示 的 那样 ， 从 一 开始 就 使 用 关系 数据 库 ， 
然后 在 进行 性 能 扩展 的 时 候 ， 才 认识 到 目 己 需要 将 数据 库 返 回 的 结果 组 
存 起 来 以 提高 性 能 。 正 如 本 章 接 下 来 要 介绍 的 和 内容 所 示 ， 对 数据 进行 持 
久 化 的 绝 大 部 分 手段 都 会 以 这 样 或 那样 的 形式 使 用 结构 ， 在 学 完 本 市 介 








绍 的 方法 之 后 ， 我 们 束 可 以 在 进行 性 能 扩展 的 时 候 ， 通 过 重 构 代码 来 将 
绥 存 数据 存储 在 内 存 里 面 ， 而 不 一 定 非 得 要 使 用 类 似 Redis 那 样 的 外 部 
内 存 数据 库 。 


因为 将 数据 存储 到 结构 里 面 对 数 据 存 储 操作 是 一 种 非常 重要 的 重 现 
手段 ， 所 以 本 间 以 及 后 续 章节 还 会 继续 提 及 这 一 技术 。 


62 ”文件 存储 


因为 内 存 存储 不 需要 访问 硬盘， 所 以 相关 操作 通常 都 会 以 风 驰 电 单 
般 的 速度 完成 。 但 内 存 存储 有 一 个 不 容 忽 视 的 缺点 ， 那 就 是 ， 存 储 在 内 
存 中 的 数据 并 不 是 持久 化 的 。 如 果 你 的 计算 机 或 者 程序 可 以 永远 也 不 关 
闭 ， 又 或 者 你 的 数据 像 缓 存 一 样 即 使 丢失 了 也 无 所 谓 ， 那 么 这 个 缺点 对 
你 来 说 是 无 伤 大 雅 的 ， 但 很 多 时 候 ， 即 使 是 对 于 绥 存 数据 来 说 ， 我 们 还 
古 希 望 数据 可 以 在 计算 机 关闭 或 者 程序 关闭 之 后 继续 存在 。 实 现 数 据 持 
久 化 有 好 几 种 不 同 的 方式 可 选 ， 其 中 最 第 见 的 英 过 于 将 数据 存储 到 诸如 
人 硬盘 或 者 内 存 这 样 的 非 易 失 存 储 器 里 面 。 


























把 数据 存储 到 非 易 失 存储 器 里 面 同样 也 有 多 种 方法 可 选 ， 而 本 节 要 
介绍 的 是 把 数据 存储 到 文件 系统 里 面 的 相关 技术 。 说 得 更 具体 一 点 ， 我 
们 将 要 学 习 的 是 如 何 通 过 Go 语言 以 两 种 不 同 的 方式 将 数据 存储 到 文件 
里 面 : 第 一 种 方式 需要 用 到 通用 的 CSV (comma-separated value， 过 号 
分 隔 值 ) 文本 格式 ， 而 第 二 种 方法 则 需要 用 到 Go 语言 特有 的 gob €. 





CSV 是 一 种 常见 的 文件 格式 ， 用 户 可 以 通过 这 种 格式 问 系 统 传递 数 
据 。 当 你 需要 用 户 提 供 大 量 数据 ， 但 是 却 因为 条 些 原因 而 无 法 让 用 户 把 


数据 填 入 你 提供 的 表单 时 ，CSV 格 式 就 可 以 派 上 用 场 了 : 你 只 需要 让 用 
户 使 用 电子 表格 程序 (spreadsheet) 输入 所 有 数据 ， 然 后 将 这 些 数据 导 
出 为 CSV 文 件 ， 并 将 其 上 传 到 你 的 Web 应 用 中 ， 这 样 就 可 以 在 获得 CSV 
文件 之 后 ， 根 据 自 己 的 需要 对 数据 进行 解码 。 同 样 地 ， 你 的 web 应 用 也 
可 以 将 用 户 的 数据 打包 成 CSV 文 件 ， 然 后 通过 向 用 户 发 送 CSV 文 件 来 为 
他 们 提供 数据 。 














gob 是 一 种 能 够 存储 在 文件 里 面 的 二 进 制 格式 ， 这 种 格式 可 以 快速 
且 高 效 地 将 内 存 中 的 数据 序列 化 到 一 个 或 多 个 文件 里 面 。 二 进 制 数据 文 
件 的 用 途 非常 多 ， 比 如 ， 在 进行 数据 备份 以 及 有 序 关机 叫 的 时 候 ， 程 
序 束 可 以 使 用 二 进 制 数据 文件 来 快速 地 存储 程序 中 的 结构 。 正 如 绥 存 机 
制 对 应 用 程序 来 说 非常 有 用 一 样 ， 能 够 将 数据 暂时 存储 在 文件 里 面 ， 并 
在 需要 的 时 候 读 取 这 些 数据 ， 对 于 实现 会 话 、 购 物 车 以 及 构建 临时 工作 
空间 (workspace) 也 是 非常 有 用 的 。 














代码 清单 6-2 展 示 了 打开 一 个 文件 并 对 其 进行 号 入 的 具体 方法 ， 在 
讨论 CSV 文 件 和 gob 二 进 制 文件 的 过 程 中 ， 类 似 的 代码 将 会 反复 出 现 。 








代码 清单 6-2 “对 文件 进行 读 写 








package main 


"io/ioutil" 
"os" 


) 


func main() { 
data := []byte("Hello World!\n") 
err := ioutil.WriteFile("data1", data, 0644) e 
if err != nil { 
panic(err) 


read1, _ := ioutil.ReadFile("data1") 
fmt.Print(string(read1)) 


file1, _ := os.Create("data2") e 
defer file1.Close() 


bytes, _ := filel.Write(data) 
fmt.Printf("Wrote %d bytes to file\n", bytes) 


file2, _ := os.Open("data2") 
defer file2.Close() 


read2 :- make([]byte, len(data)) 

bytes, _ = file2.Read(read2) 

fmt.Printf("Read Xd bytes from fileWMn", bytes) 
fmt.Println(string(read2)) 





Q 通过 WriteFile 函数 和 ReadFile 函数 对 文件 进行 号 入 和 读 取 


e 通过 File 结构 对 文件 进行 号 入 和 读 取 


为 了 减少 需要 展示 的 代码 ， 代 码 清单 6-2 中 的 程序 使 用 了 空白 标识 
符 来 省 略 各 个 函数 可 能 会 返回 的 错误 。 





在 这 个 代码 清单 里 面 ， 程 序 使 用 了 两 种 不 同 的 方法 来 对 文件 进行 写 
入 和 读 取 。 第 一 种 方法 非常 简单 直接 ， 它 使 用 的 是 ioutil 包 中 的 
WriteFile 函数 和 ReadFile 函数 : 在 写 入 文件 时 ， 程 序 会 将 文件 的 名 
字 、 需 要 写 入 的 数据 以 及 一 个 用 于 设置 文件 权限 的 数字 用 作 参 数 调 
用 WriteFile 函数 ， 而 在 读 取 文件 时 ， 程 序 只 需要 将 文件 的 名 字 用 作 参 
数 ， 然 后 调用 ReadFile 函数 即 可 。 此 外 ， 无 论 是 传递 给 WriteFile 的 
数据 ， 还 是 ReadFile 返回 的 数据 ， 都 是 一 个 由 字 贡 组 成 的 切片 。 














比 起 前 一 种 方法 ， 使 用 File 结构 该 写 文件 会 显得 更 为 麻烦 一 些 ， 








但 这 种 做 法 的 灵活 性 更 高 。 在 使 用 这 种 方法 实现 文件 写 入 时 ， 程 序 需 要 
先 调用 os 包 的 Create 函数 ， 并 通过 辐 该 函数 传 入 文件 名 来 创建 文件 。 
使 用 defer 关闭 文件 是 一 种 值得 提倡 的 做 法 ， 因 为 它 杜绝 了 用 户 在 使 用 
文件 之 后 忘记 关闭 文件 的 问题 。defer 语句 可 以 将 给 定 的 函数 调用 推 入 
到 一 个 栈 里 面 ， 保 存在 栈 中 的 调用 会 在 包含 defer 语句 的 函数 返回 之 后 
执行 。 对 我 们 的 例子 来 说 ， 这 意味 痢 file1 和 file2 将 会 在 main 函数 
执行 完毕 之 后 关闭 。 在 拥有 了 File 结构 之 后 ， 程 序 就 可 以 通过 它 的 
Write 方法 对 文件 进行 号 入 。 除 了 Write 方法 之 外 ，File 结构 还 提供 
了 其 他 几 个 用 于 写 入 文件 的 方法 。 





使 用 File 结构 读 取 文件 的 方法 跟 写 入 文件 的 方法 类 似 : 程序 需要 
使 用 os 包 的 Open 函数 打开 文件 ， 然 后 使 用 File 结构 提供 的 Read 方法 
或 者 其 他 读 取 方法 来 读 取 文 件 中 的 数据 。 因 为 File 结构 提供 了 一 些 方 
法 ， 它 们 允许 用 户 定位 并 读 取 文件 中 的 指定 部 分 ， 所 以 使 用 File 结构 
来 读 取 文件 比 起 单纯 地 调用 ReadFile 函数 拥有 更 大 的 灵活 性 。 





执行 代码 清单 6-2 所 示 的 程序 会 创建 datal 和 data2 两 个 文件 ， 它 
们 都 包含 文本 “ Hello World!”。 


6.2.1 读 取 和 写 入 CSV 文 件 


CSV 格 式 是 一 种 文件 格式 ， 它 可 以 让 文本 编辑 器 非常 方便 地 读 写 由 
文本 和 数字 组 成 的 表格 数据 。CSV 的 应 用 非常 广泛 ， 包 括 微软 的 Excel 
和 苹果 的 Numbers 在 内 的 绝 大 多 数 电 子 表 格 程 序 都 广 持 CSV 格 式 ， 因 此 
包括 Go 在 内 的 很 多 编程 语言 都 提供 了 能 够 生成 和 处 理 CSV 文 件数 据 的 函 
数 库 。 


对 Go 语言 来 说 ，CSV 文 件 可 以 通过 encoding/csv 包 进 行 操作 ， 代 
码 清单 6-3 展 示 了 如 何 通过 这 个 包 来 读 写 CSV 文 件 。 














代码 清单 6-3” 读 写 CSV 文 件 














package main 


import ( 
"encoding/csv" 
"fmt" 
"os" 
"strconv" 

) 


type Post struct { 
Id int 
Content string 
Author string 


j 
func main() { 
CsvFile, err := os.Create("posts.csv") e 
if err !- nil { 
panic(err) 


} 


defer csvFile.Close() 


allPosts :- []Post( 
Post(Id: 1, Content: "Hello World!", Author: "Sau Sheong"), 
Post(Id: 2, Content: "Bonjour Monde!", Author: "Pierre"), 
Post(Id: 3, Content: "Hola Mundo!", Author: "Pedro"), 
Post(Id: 4, Content: "Greetings Earthlings!", Author: "Sau Sheong"} 


j 


writer := csv.NewWriter(csvFile) 
for _, post := range allPosts { 
line := []stringístrconv.Itoa(post.Id), post.Content, post.Author) 


err :- writer.Write(line) 

if err != nil { 
panic(err) 

j 


} 
writer.Flush() 


file, err := os.Open("posts.csv") e 


if err != nil { 
panic(err) 


j 
defer file.Close() 


reader := csv.NewReader( file) 
reader.FieldsPerRecord - -1 
record, err := reader.ReadAll() 
if err != nil { 

panic(err) 


} 


var posts []Post 
for _, item := range record { 
id, _ := strconv.ParseInt(item[0], ©, 0) 
- Post(Id: int(id), Content: item[1], Author: item[2]) 
- append(posts, post) 
} 
fmt.Println(posts[0].Id) 
fmt.Println(posts[0].Content) 
fmt.Println(posts[0].Author) 





@ 创建 一 个 CSV 文件 


O 打开 一 个 CSV 文件 





首先 让 我 们 来 了 解 一 下 如 何 对 CSV 文 件 执 行 写 操作 。 在 一 开始 ， 程 
序 会 创建 一 个 名 为 posts .csv 的 文件 以 及 一 个 名 为 csvFile 的 变量 ， 
而 后 续 代 码 的 目标 则 是 将 allPosts 变量 中 的 所 有 帖子 都 写 入 这 个 文 
件 。 为 了 完成 这 一 目标 ， 程 序 会 使 用 NewWriter 函数 创建 一 个 新 的 写 入 
器 (writer) ， 并 把 文件 用 作 参 数 ， 将 其 传递 给 写 入 器 。 在 此 之 后 ， 程 
序 会 为 每 个 竺 写 入 的 帖子 都 创建 一 个 由 字符 串 组 成 的 切片 。 最 后 ， 程 序 
调用 写 入 器 的 Write 方法 ， 将 一 系列 由 字符 串 组 成 的 切片 写 入 之 前 创建 
的 CSV 文 件 。 








如 果 程 序 进 行 到 这 一 步 就 结束 并 退出 ， 那 么 前 面 提 到 的 所 有 数据 都 
会 被 写 入 文件 ， 但 由 于 程序 在 接 下 来 的 代码 中 立即 就 要 对 写 入 的 
posts.csv 文件 进行 读 取 ， 而 刚刚 写 入 的 数据 有 可 能 还 滞留 在 绥 冲 区 
中 ， 所 以 程序 必须 调用 写 入 器 的 Flush 方法 来 保证 缓冲 区 中 的 所 有 数据 
都 已 经 被 正确 地 写 入 文件 里 面 了 。 





读 取 CSV 文 件 的 方法 和 写 入 文件 的 方法 类 似 。 首 先 ， 程 序 会 打开 文 
件 ， 并 通过 将 文件 传递 给 NewReader 函数 来 创建 出 一 个 读 取 器 
(reader) 。 接 着 ， 程 序 会 将 读 取 器 的 FieldsPerRecord 字段 的 值 设 置 
为 负数 ， 这 样 的 话 ， 即 使 读 取 器 在 读 取 时 发 现 记录 (record) 里 面 缺 少 
了 某 些 字段 ， 读 取 进 程 也 不 会 被 中 断 。 反 之 ， 如 果 FieldsPerRecord 
字段 的 值 为 正 数 ， 那 么 这 个 值 就 是 用 户 要 求 从 每 条 记录 里 面 读 取 出 的 字 
段 数量 ， 当 读 取 器 从 CSV 文 件 里 面 读 取 出 的 字段 数量 少 于 这 个 值 时 ，Go 
就 会 抛 出 一 个 错误 。 最 后 ， 如 果 FieldsPerRecord 字段 的 值 为 6 ， 那 
么 读 取 器 就 会 将 读 取 到 的 第 一 条 记录 的 字段 数量 用 
作 FieldsPerRecord 的 值 。 





在 设置 好 FieldsPerRecord 字段 之 后 ， 程 序 会 调用 读 取 器 的 
ReadAll 方法 ， 一 次 性 地 读 取 文 件 中 包含 的 所 有 记录 ; 但 如 果 文 件 的 体 
积 较 大 ， 用 户 也 可 以 通过 读 取 器 提 供 的 其 他 方法 ， 以 每 次 一 条 记录 的 方 
式 读 取 文 件 。ReadA11 方法 将 返回 一 个 由 一 系列 切片 组 成 的 切片 作为 结 
果 ， 程 序 会 遍历 这 个 切片 ， 并 为 每 条 记录 创建 对 应 的 Post 结构 。 如 果 
我 们 运行 代码 清单 6-3 所 示 的 程序 ， 那 么 程序 将 创建 一 个 名 
为 posts.csyv 的 CSV 文 件 ， 该 文件 将 包含 以 下 多 个 由 逗号 分 隔 的 文本 
行 : 





1,Hello World!,Sau Sheong 
2,Bonjour Monde!,Pierre 


3,Hola Mundo!,Pedro 
4,Greetings Earthlings!,Sau Sheong 





除 此 之 外 ， 这 个 程序 还 会 读 取 posts.csyv 文件 ， 并 打印 出 该 文件 第 
一 行 的 内 容 : 


1 
Hello World! 


Sau Sheong 





6.2.2 ”gob 包 


encoding/gob 包 用 于 管理 由 gob 组 成 的 流 (stream) ， 这 是 一 种 在 
编码 器 Cencoder) 和 解码 器 (decoder) 之 间 进 行 交 换 的 三 进 制 数 据 ， 
这 种 数据 原本 是 为 序列 化 以 及 数据 传输 而 设计 的 ， 但 它 也 可 以 用 于 对 数 
据 进 行 持久 化 ， 并 且 为 了 让 用 户 能 够 方便 地 对 文件 进行 读 写 ， 编 码 器 和 
解码 器 一 般 都 会 分 别 包 囊 起 程序 的 写 入 器 以 及 读 取 器 。 代 码 清单 6-4 展 
示 了 如 何 使 用 gob 包 去 创建 二 进 制 数据 文件 ， 以 及 如 何 去 读 取 这 些 文 
fF. 








代码 清单 6-4 使 用 gob 包 读 写 二 进 制 数 据 

















package main 


import ( 
"bytes" 
"encoding/gob" 
"fmt" 
"io/ioutil" 


) 


type Post struct { 


Id int 
Content string 
Author string 


} 


func store(data interface{}, filename string) ( e 
buffer :- new(bytes.Buffer) 
encoder :- gob.NewEncoder(buffer) 
err :- encoder.Encode(data) 
if err !- nil { 
panic(err) 
} 
err = ioutil.WriteFile(filename, buffer.Bytes(), 0600) 
if err != nil { 
panic(err) 
} 
} 


func load(data interface{}, filename string) { e 
raw, err :- ioutil.ReadFile(filename) 
if err !- nil { 

panic(err) 
} 
buffer := bytes.NewBuffer(raw) 
dec := gob.NewDecoder(buffer) 
err - dec.Decode(data) 
if err !- nil { 
panic(err) 
} 
} 


func main() { 
post := Post{Id: 1, Content: "Hello World!", Author: "Sau Sheong"} 
store(post, "post1") 
var postRead Post 
load(&postRead, "post1") 
fmt.Println(postRead) 





@ 存储 数据 


O 载 入 数据 


跟前 面 展示 的 程序 一 样 ， 代 码 清单 6-4 所 示 的 程序 也 会 用 到 Post £5 
构 ， 并 且 也 包含 了 相应 的 store 方法 和 1load 方法 ， 但 是 跟 之 前 不 一 样 
的 是 ， 这 次 的 store 方法 会 将 帖子 存储 为 二 进 制 数据 ， 而 1oad 方法 则 
会 通过 读 取 这 些 二 进 制 数据 来 获取 帖子 。 


首先 来 分 析 一 下 store 函数 ， 这 个 函数 的 第 一 个 参数 是 一 个 空 接 
口 ， 而 第 二 个 参数 则 是 被 存储 的 二 进 制 文件 的 名 字 。 虽 然 空 接口 参数 能 
够 接受 任意 类 型 的 数据 作为 值 ， 但 是 在 这 个 函数 里 面 ， 它 接受 的 将 是 一 
个 Post 结构 。 在 接受 了 相应 的 参数 之 后 ，store 函数 会 创建 一 
个 bytes .Buffer 结构 ， 这 个 结构 实际 上 就 是 一 个 拥有 Read 方法 和 
Write 方法 的 可 变 长 度 Cvariable-sized). 字 节 缓冲 区 ， 换 句 话 
ji, bytes.Buffer 既是 读 取 器 也 是 写 入 右 。 


在 此 之 后 ，store 函数 会 把 缓冲 区 传递 给 NewEncoder 函数 ， 以 此 
来 创建 出 一 个 gob 编 码 器 ， 接 着 调用 编码 占 的 Encode 方法 将 数据 (也 束 
是 Post 结构 ) 编码 到 缓冲 区 里 面 ， 最 后 再 将 缓冲 区 中 己 编 码 的 数据 写 
入 文件 。 





程序 在 调用 store 函数 时 ， 会 将 一 个 Post 结构 和 一 个 文件 名 作为 
参数 ， 而 这 个 函数 则 会 创建 出 一 个 名 为 post1 的 二 进 制 数据 文件 。 


接 下 来 ， 让 我 们 来 研究 一 下 load 函数 ， 这 个 函数 从 二 进 制 数 据 文 
件 中 载 入 数据 的 步 又 跟 创建 并 写 入 这 个 文件 的 步 又 正好 相反 : 首先 ， 程 
序 会 从 文件 里 面 读 取出 未 经 处 理 的 原始 数据 ; 接着， 程序 会 根据 这 些 原 
始 数据 创建 一 个 缓冲 区 ， 并 和 类 此 为 原始 数据 提供 相应 的 Read 方法 和 
Write 方法 ; 在 此 之 后 ， 程 序 会 调用 NewDecoder 函数 ， 为 缓冲 区 创建 





相应 的 解码 器 ， 然 后 使 用 解码 喜 去 解码 从 文件 中 读 取 的 原始 数据 ， 并 最 
终 得 到 之 前 写 入 的 Post 结构 。 


Emain 函数 里 面 ， 程 序 定 义 了 一 个 名 为 postRead 的 Post 结构 ， 
并 将 这 个 结构 的 引用 以 及 二 进 制 数据 文件 的 名 字 传 递 给 了 load 函数 ， 
而 load 函数 则 会 把 读 取 二 进 制 文件 所 得 的 数据 载 入 给 定 的 Post 结构 。 


当 我 们 运行 代码 清单 6-4 所 示 的 程序 时 ， 将 创建 出 一 个 包含 二 进 制 
数据 的 post1 文件 一 一 因为 这 个 文件 包含 的 是 二 进 制 数 据 ， 所 以 如 果 直 
接 打 开 这 个 文件 ， 将 会 看 到 一 些 似乎 晤 无 意义 的 数据 。 除 创建 post1 X 
件 之 外 ， 程 序 还 会 读 取 文件 中 的 数据 并 将 其 载 入 Post 结构 里 面 ， 然 后 
在 控制 终端 打印 出 这 个 结构 : 


{1 Hello World! Sau Sheong} 


好 了 ， 关 于 使 用 文件 存储 数据 的 介绍 到 此 就 结束 了 ， 本 间接 下 来 的 
内 容 将 会 讨论 如 何 将 数据 存储 到 一 种 名 为 数据 库 服务 器 的 特殊 服务 右 端 
程序 里 面 。 
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在 内 存 和 文件 系统 上 存储 和 访问 数据 虽然 非常 有 用 ， 但 如 果 你 希望 
在 一 个 健壮 并 且 可 扩展 的 环境 里 面 存储 数据 ， 就 需要 转 同 使 用 数据 库 服 
务 嚣 (database server) 。 数 据 库 服 务 器 是 一 种 程序 ， 它 可 以 让 其 他 程 
序 通过 客户 端 -服务 器 模型 (client-server model) 来 访问 数据 ， 并 且 这 种 
访问 只 能 通过 数据 库 服 务 器 实现 ， 而 其 他 形式 的 访问 则 会 被 拒绝 。 在 通 


党 情况 下 ， 数 据 库 服务 器 的 客户 端 既 可 以 是 一 个 函数 库 ， 也 可 以 是 男 一 
个 程序 ， 这 个 客户 端 会 与 数据 库 服务 器 进行 连接 ， 然 后 通过 结构 化 查询 
语言 (structured query language, SQL) 对 数据 进行 访问 。 数 据 库 服务 

器 通常 会 作为 系统 的 一 部 分 ， 出 现在 数据 库 管 理 系统 〈database 


management system) 中 。 


关系 数据 库 管理 系统 relational database management system, 
RDBMS) 也 许 是 最 常见 也 最 流行 的 数据 库 管 理 系 统 了 ， 这 种 系统 使 用 
的 是 基于 数据 的 关系 模型 构建 的 关系 数据 库 。 在 绝 大 多 数 情况 下 ， 关 
系数 据 库 服务 器 都 是 通过 SQL 来 访问 关系 数据 库 的 。 








关系 数据 库 和 SQL 是 人 们 在 实现 可 扩展 并 且 易 于 使 用 的 数据 存储 方 
法 时 最 为 常见 的 手段 。 本 书 曾 经 在 第 2 章 对 关系 数据 库 以 及 SQL 做 过 简 
单 的 介绍 ， 而 我 们 接 下 来 要 做 的 是 更 加 深入 地 了 解 这 两 项 技术 。 


6.3.1 设置 数据 库 
在 开始 学 习 本 市 介绍 的 知识 之 前 ， 读 者 首先 要 做 的 就 是 对 数据 库 进 
行 设置 。 本 书 在 第 2 半 束 曾经 介绍 过 安装 并 设置 Postgres 的 具体 方法 ， 


为 本 节 还 会 继续 用 到 Postgres 数 据 库 ， 所 以 如 果 你 尚未 安装 或 者 设置 好 
这 个 数据 库 ， 那 么 请 根据 第 2 章 介 绍 的 方法 进行 设置 。 











在 局 动 并 设置 好 数据 库 之 后 ， 我 们 还 需要 执行 以 下 3 个 步 又 : 
(1) 创建 数据 库 用 户 ; 


(20 为 用 户 创 建 数据 库 ; 


(3) 运行 安 冯 脚本， 创建 执行 相关 操作 历 希 的 表 。 


首先 ， 我 们 可 以 通过 在 命令 行 执行 以 下 命令 来 创建 数据 库 用 户 : 


createuser -P -d gwp 


这 一 命令 会 创建 出 一 个 名 为 gwp 的 Postgres 数 据 库 有 用户， 其 中 -P xt 
项 会 让 createuser 程序 在 执行 时 弹出 一 个 提示 符 ， 只 需要 在 提示 符 出 
现 之 后 输入 相应 的 字符 串 ， 就 可 以 将 其 设置 为 gwp 用 户 的 密码 ， 而 -d 选 
项 则 会 赋予 gwp 用 户 创建 数据 库 所 需 的 权限 。 





RE, RIEN gwp 用 户 创建 数据 库 。 通 过 在 命令 行 执行 以 下 
命令 ， 我 们 束 可 以 创建 一 个 名 为 gwp 的 数据 库 : 


createdb gwp 


注意 ， 这 个 数据 库 的 名 字 跟 我 们 刚刚 创建 的 数据 库 用 户 的 名 字 是 一 
样 的 ， 都 是 gwp。 虽 然 数据 库 用 户 也 可 以 创建 与 目 己 名 字 不 同 的 数据 
库 ， 但 这 样 做 需要 额外 的 权限 设置 ， 所 以 为 了 让 事情 尽 可 能 简单 ， 我 们 
这 里 将 使 用 默认 的 数据 库 命 名 方式 ， 也 就 是 ， 为 数据 库 用 户 创建 一 个 与 
之 同名 的 数据 库 。 








在 拥有 了 数据 库 之 后 ， 我 们 还 需要 创建 一 个 表 ， 这 个 表 也 是 接 下 来 
的 内 容 中 我 们 唯一 需要 使 用 的 表 。 首 先 ， 我 们 需要 创建 一 个 名 
为 setup.sql 的 文件 ， 并 将 代码 清单 6-5 所 示 的 内 容 键 入 该 文件 中 。 





代码 清单 6-5 ”用 于 创建 表 的 脚本 

















create table posts ( 
id serial primary key, 
content text, 


author varchar(255) 





接着 ， 我 们 还 需要 在 命令 行 执 行 以 下 命令 : 


psql -U gwp -f setup.sql -d gwp 


XFER, JE TUBE PREHRA ERE S o EA, (ET 
次 执行 后 续 展 示 的 代码 之 前 ， 你 可 能 都 需要 重复 执行 一 次 这 条 命令 ， 以 
便 清理 并 设置 数据 库 。 
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在 创建 并 设置 好 数据 库 之 后 ， 现 在 是 时 候 来 连接 这 个 数据 库 了 。 代 
码 清单 6-6 展 示 了 一 个 名 为 store.go pu 文件 中 的 代码 对 Postgres 
执行 了 一 系列 操作 ， 而 接 下 来 的 小 节 将 会 逐一 地 分 析 这 些 操 作 的 实现 原 
理 。 


























代码 清单 6-6 ”使 用 Go 对 Postgres 执 行 CRUD 操 作 





package main 


import ( 

"database/sql" 

"fmt" 

_ "github.com/lib/pq" 
) 


type Post struct { 
Id int 
Content string 
Author string 

} 

var Db *sql.DB 

func init() { 


var err error 
Db, err = sql.Open("postgres", "user-gwp dbname-gwp password-gwp 
esslmode-disable") e 


if err != nil { 
panic(err) 
} 
} 
func Posts(limit int) (posts []Post, err error) { 
rows, err := Db.Query("select id, content, author from posts limit $1" 
Pj 
e limit) 
if err !- nil { 
return 
j 


for rows.Next() ( 
post := Posti) 
err - rows.Scan(&post.Id, &post.Content, &post.Author) 
if err != nil { 
return 
} 
posts = append(posts, post) 
} 
rows.Close() 
return 


} 


func GetPost(id int) (post Post, err error) ( e 
post = Posti) 
err - Db.QueryRow("select id, content, author from posts where id - 
w$1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 
j 
func (post *Post) Create() (err error) ( e 
statement :- "insert into posts (content, author) values ($1, $2) 
wreturning id" 
stmt, err :- Db.Prepare(statement) 
if err != nil { 
return 
j 


defer stmt.Close() 
err - stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


} 


func (post *Post) Update() (err error) ( 


_, err = Db.Exec("update posts set content = $2, author = $3 where id 


w $1", post.Id, post.Content, post.Author) e 
return 


} 


func (post *Post) Delete() (err error) ( 
_, err = Db.Exec("delete from posts where id = $1", post.Id) e 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong") 
© 
fmt.Println(post) 
post.Create() 
fmt.Println(post) e 


readPost, _ := GetPost(post.Id) 
fmt.Println(readPost) © 


readPost.Content - "Bonjour Monde!" 
readPost.Author - "Pierre" 


readPost.Update() 


posts, _ := Posts() 
fmt.Println(posts) e 


readPost.Delete() 





@ 连接 到 数据 库 


e 获取 单独 一 篇 帖子 
e 创建 一 篇 新 帖子 
O 更 新 帖子 


O 删除 一 篇 帖子 


Q (0 Hello World! Sau Sheong} 

@ (1 Hello World! Sau Sheong} 

Q (1 Hello World! Sau Sheong) 

© [(1 Bonjour Monde! Pierre] ] 
6.3.2 ”连接 数据 库 


程序 在 对 数据 库 执 行 任何 操作 之 前 ， 都 需要 先 与 数据 库 进 行 连接 ， 
代码 清单 6-7 展 示 了 实现 这 一 动作 的 具体 过 程 : 程序 首先 使 用 Db 变量 定 
义 了 一 个 指向 sql.DB 结构 的 指针 ， 然 后 使 用 init() 函数 来 初始 化 这 个 
变量 《Go 语言 的 每 个 包 都 会 目 动 调用 定义 在 包 内 的 init() 函数 ) 。 





























代码 清单 6-7 ”用 于 创建 数据 库 句柄 的 函数 


var Db *sq1.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user-gwp dbname-gwp password-gwp 


sslmode-disable") 
if err !- nil { 
panic(err) 
} 
} 





sql.DB 结构 是 一 个 数据 库 句 柄 (handle) ， 它 代表 的 是 一 个 包含 
了 零 个 或 任意 多 个 数据 库 连 接 的 连接 池 〈pool) ， 这 个 连接 池 由 sql 包 
管理 。 程 序 可 以 通过 调用 Open 函数 ， 并 将 相应 的 数据 库 驱 动 名 字 
(driver name) 以 及 数据 源 名 字 (data source name) 传递 给 该 函数 来 建 





立 与 数据 库 的 连接 。 比 如 ， 在 上 面 展示 的 例子 中 ， 程 序 使 用 的 是 
postgres 驱 动 。 数 据 源 名 字 是 一 个 特定 于 数据 库 驱 动 的 字符 串 ， 它 会 告 
诉 驱动 应 该 如 何 与 数据 库 进行 连接 。0pen 函数 在 执行 之 后 会 返回 一 个 
指 癌 sql.DB 结构 的 指针 作为 结果 。 





需要 注意 的 是 ，0pen 函数 在 执行 时 并 不 会 真正 地 与 数据 库 进 行 连 
接 ， 它 甚至 不 会 检查 用 户 给 定 的 参数 : Open 函数 的 真正 作用 是 设置 好 
连接 数据 库 所 需 的 各 个 结构 ， 并 以 惰性 的 方式 ， 等 到 真正 需要 时 才 建 立 
相应 的 数据 库 连接 。 


此 外 ， 因 为 sq1.DB 只 古 一 个 句 顶 而 不 是 实际 的 连接 ， 而 这 个 句柄 
代表 的 是 一 个 会 自动 对 连接 进行 管理 的 连接 池 ， 所 以 尽管 用 户 可 以 手动 
关闭 sql.DB ， 但 是 在 实际 中 通常 并 不 需要 这 样 做 。 在 上 面 展 示 的 例子 
中 ， 程 序 通过 全 局 定义 的 Db 变量 在 各 个 CRUD 方 法 以 及 函数 中 使 
Hisql.DB 结构 ; 但 除 此 之 外 ， 我 们 也 可 以 选择 在 创建 sq1.DB 结构 之 
后 ， 通 过 同方 法 或 者 函数 传递 这 个 结构 的 方式 来 使 用 它 。 





到 目前 为 止 ， 我 们 讨论 的 都 是 0pen 函数 ， 这 个 函数 接受 数据 库 驱 
动 名 字 和 数据 源 名 字 作 为 参数 ， 然 后 返回 一 个 sql .DB 结构 作为 结果 。 
那么 程序 本 里 又 是 如 何 获取 数据 库 驱 动 的 呢 ? 一 般 来 说 ， 程 序 都 会 
辣 Register 函数 提供 一 个 数据 库 驱 动 名 字 以 及 一 个 实现 了 
driver.Driver 接口 的 结构 ， 以 此 来 注册 将 要 用 到 的 数据 库 驱 动 ， 就 
像 这 样 : 


sql.Register("postgres", &drv{}) 




















这 个 例子 中 的 postgres 就 是 数据 库 驱 动 的 名 字 ， 而 drv 则 是 实现 
了 Driver 接口 的 结构 。 你 也 许 已 经 注意 到 了 ， 前 面 展示 的 数据 库 程序 
并 没有 包含 类 似 的 注册 代码 ， 这 是 因为 程序 使 用 的 第 三 方 Postgres 驱 动 
在 被 导入 的 时 候 已 经 自行 实现 了 注册 : 





"database/sql" 


_ "github.com/lib/pq" 








上 面 这 段 代 码 中 的 github.com/1ib/pq 包 就 是 程序 导入 的 Postgres 
驱动 ， 在 导入 这 个 包 之 后 ， 包 内 定义 的 ijnit 函数 就 会 被 调用 ， 并 对 其 
自身 进行 注册 。 因 为 Go 语言 没有 提供 任何 官方 数据 库 驱 动 ， 所 以 Go 语 
言 的 所 有 数据 库 驱 动 都 是 第 三 方 函数 库 ， 并 且 这 些 库 必须 遵守 
sql.driver 包 中 定义 的 接口 。 注 意 ， 因 为 程序 在 操作 数据 库 的 时 候 只 
需要 用 到 database/sql ， 而 不 需要 直接 使 用 数据 库 驱 动 ， 所 以 程序 在 
导入 Postgres 数 据 库 驱 动 的 时 候 将 这 个 包 的 名 字 设 置 成 了 下 划 线 C 。 
这 种 引用 数据 库 驱 动 的 方式 可 以 让 用 户 在 不 修改 代码 的 情况 下 升级 驱 
动 ， 或 者 修改 驱动 实现 。 

















至 于 安装 驱动 这 一 操作 ， 则 可 以 通过 在 命令 行 里 执行 以 下 命令 来 完 
成 : 


go get "github.com/lib/pq" 


这 一 命令 会 从 代码 库 中 获取 驱动 的 具体 代码 ， 并 将 这 些 代码 放置 到 
包 库 (package repository) 里 面 ， 当 需要 用 到 这 个 驱动 时 ， 编 译 器 就 会 








把 驱动 代码 与 用 户 编写 的 代码 一 同 编译 。 
6.3.3 ”创建 帖子 


在 完成 了 数据 库 的 初步 设置 之 后 ， 现 在 是 时 候 创建 我 们 的 首 条 数据 
库 记录 了 。 本 节 还 会 用 到 之 前 几 节 展示 过 的 Post 结构 ， 跟 之 前 不 一 样 
的 是 ， 这 次 展示 的 程序 将 不 会 再 把 post 结构 包含 的 信息 存储 到 内 存 或 
者 文件 中 ， 而 是 把 这 些 信息 存储 到 Postgres 数 据 库 中 ， 并 在 需要 的 时 候 
从 数据 库 中 获取 这 些 信息 。 














前 面 的 示例 程序 向 我 们 展示 了 如 何 使 用 不 同 的 函数 执行 数据 的 创 
建 、 获 取 、 更 新 和 删除 操作 ， 而 在 这 一 节 ， 我 们 将 会 了 解 到 使 
用 Create 函数 创建 新 帖子 的 更 多 细节 。 在 仔细 研究 Create 函数 的 代码 
之 前 ， 让 我 们 先 来 了 解 一 下 创建 帖子 的 具体 步骤 。 


创建 帖子 首先 要 做 的 是 创建 一 个 Post 结构 ， 并 为 该 结构 的 
Content 字段 和 Author 字段 设置 值 。 需 要 注意 的 是 ， 因 为 结构 的 Id 字 
段 的 值 通常 是 由 数据 库 的 自 增 主键 自动 生成 的 ， 所 以 我 们 并 不 需要 为 这 
个 字段 设置 值 。 





post := Post(Content: "Hello World!", Author: "Sau Sheong") 





如 果 我 们 现在 使 用 一 个 fmt . Prántln 语句 打印 这 个 结构 ， 会 看 
到 Id 字段 的 值 被 初始 化 成 了 8 : 


fmt.Println(post) e 


@ (0 Hello World! Sau Sheong) 


现在 ， 我 们 可 以 通过 执行 Post 结构 的 Create 方法 ， 把 结构 中 包含 
的 数据 存储 到 数据 库 的 记录 Gecord) 里 面 : 


post.Create() 


Create 方法 在 发 生 故 障 时 会 返回 一 个 错误 ， 但 为 了 让 代码 保持 简 
单 ， 我 们 这 里 暂且 先 省 略 相 应 的 错误 处 理 人 代码。 现在， 再 次 打印 这 
个 Post 结构 : 


fmt.Println(post) e 


@ (1 Hello World! Sau Sheong} 


从 打印 的 结果 可 以 看 到 ，Id 字段 的 值 现在 被 设置 成 了 1 。 在 了 解 了 
fi Hi Create 函数 创建 新 帖子 的 具体 步骤 之 后 ， 现 在 是 时 候 来 看 看 代码 
清单 6-8， 了 解 一 下 它 的 具体 实现 代码 了 。 





代码 清单 6-8 创建 一 篇 帖子 








func (post *Post) Create() (err error) ( 
statement :- "insert into posts (content, author) values ($1, $2) 
wreturning id " 
stmt, err :- db.Prepare(statement) 
if err !- nil { 
return 


defer stmt.Close() 
err - stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
if err !- nil { 

return 


} 


return 


EO 
Create 函数 是 Post 结构 的 一 个 方法 ， 这 一 点 可 以 通过 Create K 
数 的 定义 看 出 : 在 func 关键 字 和 函数 名 Create 之 间 ， 有 一 个 指 同 Post 
结构 的 引用 ， 这 个 名 为 post 的 引用 也 被 称 为 方法 的 接收 者 
(receiver) ， 接 收 者 可 以 不 使 用 & 符号 ， 直 接 在 方法 内 部 对 结构 进行 引 
HR. 


Create 方法 做 的 第 一 件 事 是 定义 一 条 SQL 预 处 理 语句 ， 一 条 预 处 
理 语句 (prepared statement) 束 是 一 个 SQL 语 句 模 板 ， 这 种 语句 通常 用 
于 重复 执行 指定 的 SQL 语句 ， 用 户 在 执行 预 处 理 语句 时 需要 为 语句 中 的 
参数 提供 实际 值 。 


比如 ， 在 创建 数据 库 记 录 的 时 候 ，Create 函数 就 会 使 用 实际 值 去 
蔡 换 以 下 语句 中 的 $1 和 $2 : 





statement :- "insert into posts (content, author) values ($1, $2) returnin 
g id" 





除了 在 数据 库 里 面 创建 记录 之 外 ， 这 个 语句 还 会 要 求 数据 库 返 回 id 
列 的 值 ， 本 文 稍 后 就 会 说 明 这 样 做 的 具体 原因 。 


为 了 创建 预 处 理 语句 ， 程 序 使 用 了 sql1.DB 结构 的 Prepare 方法 : 


stmt, err := db.Prepare(statement) 


这 行 代码 会 创建 一 个 指向 sql.Stmt 接口 的 引用 ， 这 个 引用 就 是 上 





面 提 到 的 预 处 理 语 句 。sq1l.Stmt 接口 的 定义 位 于 sql.Driver 包 当 
中 ， 而 具体 的 结构 则 由 数据 库 驱 动 实现 。 


之 后 ， 程 序 会 调用 预 处 理 语句 的 QueryRow 方法 ， 并 把 来 自 接收 者 
的 数据 传递 给 该 方法 ， 以 此 来 执行 预 处 理 语 句 : 


err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 


我 们 之 所 以 在 这 里 使 用 QueryRow 方法 ， 是 因为 我 们 只 想 要 获取 一 
个 指 问 sql.Row 结构 的 引用 : 如 果 QueryRow 发 现 被 执行 的 SQL 语句 返 
回 了 多 于 一 个 sql.Row ， 那 么 它 只 会 返回 结果 中 的 第 一 个 sql.Row Jf 
丢弃 剩余 的 所 有 sql.Row 。 因 为 QueryRow 方法 的 返回 值 只 有 一 
个 sql.Row 结构 ， 它 不 会 返回 任何 错误 ， 所 以 QueryRow 方法 通常 会 跟 
Row 结构 的 Scan 方法 搭配 使 用 ， 并 由 Scan 方法 把 行 中 的 值 复 制 到 程序 
为 其 提供 的 参数 里 面 。 正 如 上 面 的 代码 所 示 ，Scan 方法 会 把 SQL 查询 
语句 返回 的 id 列 的 值 设 置 为 post 接收 者 的 Id 字段 的 值 ， 这 也 是 我 们 前 
面 在 编写 预 处 理 语句 时 ， 要 求 SQL 查 询 语句 返回 id 列 的 值 的 原因 。 很 
明显 ， 因 为 接收 者 的 Content 字段 和 Author 字段 都 已 经 有 值 了 ， 所 以 
程序 最 后 要 做 的 就 是 将 接收 者 的 Id 字段 的 值 设 置 成 数据 库 生成 的 自 增 
整数 。 现 在 ， 正 如 你 所 料 ， 因 为 post 变量 的 Id 字段 也 已 经 设置 了 值 ， 
所 以 程序 得 到 的 将 是 一 个 完整 地 进行 了 设置 的 Post 结构 ， 并 且 该 结构 
包含 的 数据 与 数据 库 记 录 的 数据 完全 一 致 。 


6.3.4 获取 帖子 
在 学 会 如 何 创建 帖子 之 后 ， 我 们 很 自然 地 就 要 学 习 如 何 获 取 帖 子 





了 。 跟 前 面 一 样 ， 在 编写 获取 帖子 的 函数 之 前 ， 我 们 需要 先 了 解 一 下 获 
取 帖 子 的 具体 步骤 。 因 为 程序 在 党 试 获取 帖子 的 时 候 是 没有 现成 的 Post 
结构 可 用 的 ， 所 以 它 目 然 也 无 法 通过 为 Post 结构 定义 方法 来 获取 帖子 

了 。 为 此 ， 程 序 需 要 定义 一 个 GetPost 函数 ， 这 个 函数 接受 帖子 的 Id 作 
为 参数 ， 并 返回 一 个 包含 了 完整 帖子 数据 的 Post 结构 作为 结果 : 





readPost, _ := GetPost(1) 
fmt.Println(readPost) e 


@ (1 Hello World! Sau Sheong} 


这 段 代 码 没 有 像 之 前 展示 过 的 代码 清单 那样 ， 向 GetPost 函数 传 
递 post.Id 变量 ， 而 是 直接 向 GetPost 函数 传递 了 帖子 的 ID 值 1 MA 
此 来 强调 函数 是 通过 帖子 ID 来 获取 帖子 的 。 代 码 清单 6-9 展 示 了 
具 


GetPost 函数 的 具体 实现 代码 。 





代码 清单 6-9 ”获取 一 篇 帖子 





func GetPost(id int) (post Post, err error) ( 
post = Posti) 
err - Db.QueryRow("select id, content, author from posts where id - 


w$1", id).Scan(&post.Id, &post.Content, &post.Author) 
return 





GetPost 函数 首先 创建 了 一 个 空 的 Post 结构 ， 然 后 在 对 结构 进行 
设置 之 后 ， 将 其 用 作 函 数 的 返回 值 : 


post = Post{} 





跟 之 前 一 样 ， 程 序 通过 串联 QueryRow 方法 和 Scan 方法 ， 将 执行 查 
询 所 得 的 数据 复制 到 空 的 Post 结构 里 面 。 需 要 注意 的 是 ， 因 为 获取 单 
个 帖子 无 需 重 复 执 行 相同 的 SQL 语句 ， 上 所 以 程序 使 用 的 是 sq1.DB 结构 
的 QueryRow 方法 而 不 是 sql .Stmt 结构 的 QueryRow 方法 。 实 际 
E, Create 方法 和 GetpPost 函数 既 可 以 使 用 sq1.DB 来 实现 ， 也 可 以 使 
Hisql.Stmt 来 实现 ， 在 这 里 使 用 sq1.DB 而 不 是 沿用 sql.Stmt 只 是 为 
了 展示 另 一 种 可 行 的 做 法 。 














在 将 数据 库 包 含 的 数据 填充 到 空 的 Post 结构 之 后 ，GetPost 就 会 
将 这 个 结构 返回 给 调用 函数 。 
6.3.5 更 新 帖子 

在 学 会 如 何 获 取 帖 子 之 后 ， 我 们 接 下 来 要 做 的 就 是 学 习 如 何 对 数据 
库 记 录 中 的 信息 进行 更 新 。 假 设 现在 程序 已 经 通过 获取 操作 把 帖子 保存 
到 了 readPost 变量 里 面 ， 那 么 它 应 该 可 以 对 帖子 进行 修改 ， 并 通过 更 
新 操作 将 这 些 修改 反映 至 数据 库 : 














readPost.Content = "Bonjour Monde!" 
readPost.Author = "Pierre" 


readPost.Update() 





更 新 操作 可 以 通过 为 Post 结构 添加 Update 方法 来 实现 ， 代 码 清单 
6-10 展 示 了 这 个 方法 的 具体 实现 代码 。 


代码 清单 6-10 ”更 新 一 篇 帖子 











func (post *Post) Update() (err error) ( 
_, err = Db.Exec("update posts set content = $2, author = $3 where id 


w $1", post.Id, post.Content, post.Author) 
return 


} 


跟 创 建 帖子 时 的 做 法 不 同 ， 这 次 展示 的 更 新 操作 没有 使 用 预 处 理 语 
句 ， 而 是 直接 调用 sq1.DB 结构 的 Exec 方法 。 这 是 因为 程序 既 不 需要 对 
接收 者 进行 任何 更 新 ， 也 不 需要 对 方法 返回 的 结果 进行 扫描 (scan)， 
所 以 它 才 会 选择 使 用 速度 更 快 的 Exec 方法 来 执行 得 询 : 


_, err = Db.Exec(post.Id, post.Content, post.Author) 


Exec 方法 会 返回 一 个 sql.Result 和 一 个 可 能 出 现 的 错误 ， 其 中 
sql.Result 记录 的 是 受 查 询 影 响 的 行 的 数量 以 及 可 能 会 出 现 的 最 后 插 
入 id。 因 为 更 新 操作 对 sql.Result 记录 的 这 两 项 信息 都 不 感 兴趣 ， 所 
以 程序 会 通过 将 sql.Result 赋值 给 下 划 线 ( o 来 忽略 它 。 如 果 一 切 
顺利 ， 没 有 出 现 错误 ， 当 Exec 执行 完毕 时 ， 给 定 的 帖子 就 会 被 更 新 。 











6.3.6 ”删除 帖子 

到 目前 为 止 ， 我 们 已 经 学 习 了 如 何 创建 、 获 取 和 更 新 帖子 ， 那 么 接 
下 来 要 考虑 的 就 是 如 何在 不 需要 这 些 帖 子 的 时 候 删 除 它 们 了 。 比 如 说 ， 
假设 程序 已 经 通过 获取 操作 将 一 篇 帖子 存储 到 了 readPost 变量 里 面 ， 
那么 接 下 来 就 可 以 通过 调用 readPost 变量 的 Delete 方法 来 删除 帖子 : 


readPost.Delete() 


Delete 方法 的 用 法 非常 简单 ， 代 码 清 单 6-11 展 示 了 这 个 方法 的 具 
体 定 义 ， 里 面 使 用 的 都 是 前 面 已 经 介绍 过 的 技术 。 


代码 清单 6-11 删除 一 篇 帖子 





func (post *Post) Delete() (err error) ( 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 


return 


} 





跟前 面 更 新 帖子 时 一 样 ，Delete 方法 直接 通过 调用 sql1 .DB 结构 的 
Exec 方法 来 执行 SQL 查询 ， 并 且 因 为 Delete 方法 也 对 Exec 方法 返回 
的 结果 不 感 兴趣 ， 所 以 它 也 会 把 Exec 返回 的 结果 赋值 给 了 下 划 线 C) 


也 许 你 已 经 注意 到 了 ， 与 Post 结构 有 关 的 各 个 方法 以 及 函数 部 是 
以 一 种 非常 随意 的 方式 进行 定义 的 ， 所 以 在 需要 的 时 候 ， 你 也 可 以 根据 
自己 的 想法 来 修改 这 些 方法 和 函数 。 举 个 例子 ， 除 了 “ 先 修改 已 有 的 
Post 结构 ， 然 后 再 调用 Update 方法 将 更 新 反映 到 数据 库 里 面 * 这 种 更 
新 方法 之 外 ， 你 还 可 以 考虑 直接 将 需要 修改 的 内 容 当 作 参数 传递 给 
Update 方法 ; 又 或 者 说 ， 你 也 可 以 考虑 创建 更 多 不 同 的 获取 函数 ， 然 
后 通过 特定 的 列 或 者 特定 的 过 滤 占 来 获取 你 想 要 的 帖子 。 


6.3.7 一 次 获取 多 篇 帖子 


根据 给 定 的 最 大 帖子 数量 ， 一 次 从 数据 库 里 面 获取 多 篇 帖子 ， 是 
种 非 第 第 见 的 做 法 。 换 句 话 说 ， 程 序 可 以 通过 执行 以 下 命令 ， 从 数据 库 
里 面 获取 前 十 篇 帖子 ， 并 将 它们 放 入 到 一 个 切片 里 面 : 


posts, _ := Posts(10) 


代码 清单 6-12 展 示 了 完成 这 一 操作 的 Posts 函数 的 具体 定义 。 














代码 清单 6-12 一 次 获取 多 篇 帖子 





func Posts(limit int) (posts []Post, err error) { 
rows, err :- Db.Query("select id, content, author from posts limit $1" 


e limit) 
if err != nil ( 
return 


for rows.Next() ( 
post := Posti) 


err - rows.Scan(&post.Id, &post.Content, &post.Author) 
if err !- nil { 
return 


} 
posts = append(posts, post) 


rows.Close() 
return 








Posts 函数 使 用 了 sql1.DB 结构 的 Query 方法 来 执行 查询 ， 这 个 方 
法 会 返回 一 个 Rows 接口 。Rows 接口 是 一 个 迭代 器 ， 程 序 可 以 通过 重复 
调用 它 的 Next 方法 来 对 其 进行 迭代 并 获得 相应 的 sql.Row ; 当 所 有 行 
都 被 迭代 完毕 时 ，Next 方法 将 返回 io.EOF 作为 结果 。 


Posts 函数 在 每 次 进行 迭代 的 时 候 都 会 创建 一 个 Post 结构 ， 并 将 

包含 的 数据 扫描 到 结构 里 面 ， 然 后 再 将 这 en 切片 的 
in ee Posts ZU XT agre 
个 Post 结构 的 posts 切片 返回 给 调用 者 。 


64 Go 与 SQL 的 关系 


关系 数据 库 之 所 以 能 够 成 为 一 种 流行 的 数据 存储 手段 ， 其 中 一 个 原 





因 就 是 它 可 以 在 表 与 表 之 间 建 立 天 系 ， 从 而 使 不 同 的 数据 能 够 以 一 种 一 
致 且 易 于 理解 的 方式 互相 进行 关联 。 基 本 上 ， 有 4 种 方法 可 以 把 一 项 记 
录 与 其 他 记录 关联 起 来 : 


e 一 对 一 关联 ， 也 被 称 为 “有 一 个 ”(has one) 关系， 比如 一 个 用 户 必 
然 会 拥有 一 个 个 人 简介 ; 

e 一 对 多 关联 ， 也 被 称 为 “有 多 个 ”(has many) 关系 ， 比 如 一 个 用 户 
可 能 会 拥有 多 篇 论坛 帖子 ; 

e 多 对 一 关联 ， 也 被 称 为 “属于 ”(belongs to) 关系 ， 比 如 多 篇 论坛 
帖子 可 能 会 同属 于 某 一 个 用 户 ; 

e 多 对 多 关联 ， 比如 一 个 用 户 可 能 会 参与 论坛 里 面 多 篇 帖子 的 讨 
论 ， 而 一 篇 帖子 里 面 也 会 有 多 个 用 户 在 发 表 评 论 。 





在 前 面 的 内 容 中 ， 我 们 已 经 学 习 了 如 何 对 单个 数据 库 表 执 行 标 准 的 
CRUD 操 作 ， 但 我 们 还 不 知道 如 何 才 能 对 两 个 相关 联 的 表 执 行 相同 的 操 
作 。 因 此 ， 在 这 一 节 ， 我 们 将 要 学 习 如 何 通 过 一 对 多 关系 为 一 篇 论坛 由 
子 构建 多 篇 评论 。 与 此 同时 ， 因 为 一 对 多 关系 跟 多 对 一 关系 实际 上 就 是 
一 体 两 面 的 两 个 东西 ， 所 以 除了 一 对 多 关系 之 外 ， 我 们 还 会 学 习 如 何 使 
用 多 对 一 关系 。 


6.4.1 设置 数据 库 


在 正式 开始 之 前 ， 我 们 需要 再 次 对 数据 库 进行 设置 ， 不 过 跟 上 次 只 
创建 一 个 表 的 做 法 不 同 ， 这 一 次 我 们 将 会 创建 两 个 表 。 此 外 ， 这 次 设置 
需要 用 到 的 命令 跟 上 一 次 设置 使 用 的 命令 完全 一 样 ， 只 是 被 执行 的 
setup. sql 脚本 跟 之 前 的 有 所 不 同 ， 代 码 清单 6-13 展 示 了 新 脚本 的 具体 
定义 。 

















代码 清单 6-13 包 


c— 


建 两 个 相关 联 的 表 





drop table posts cascade if exists; 
drop table comments if exists; 


create table posts ( 

id serial primary key, 
content text, 

author varchar(255) 

); 


create table comments ( 

id serial primary key, 

content text, 

author varchar(255), 

post id integer references posts(id) 


) ; 





这 次 的 脚本 除了 会 创建 posts 表 之 外 ， 还 会 创建 comments 
K, comments 表 的 大 部 分 列 都 跟 posts 表 一 样 ， 主 要 区 别 在 于 
comments 表 多 了 一 个 额外 的 post_id 列 : 这 个 post_id 会 作为 外 键 
(foreign key) ， 对 posts 表 的 主键 id 进行 引用 。 此 外 ， 因 为 posts 表 
和 comments 表现 在 已 经 通过 主键 和 外 键 建立 起 了 关联 ， 所 以 用 户 在 删 
除 posts 表 的 同时 也 需要 将 comments 表 一 并 删除 ， 否 则 ， 由 于 
comments 表 对 posts 表 的 依赖 关系 ， 删 除 posts 表 这 一 操作 将 无 法 正 
常 执行 。 


设置 好 相应 的 数据 库 表 之 后 ， 现 在 让 我 们 来 看 看 如 何 使 用 Go 语言 
实现 一 对 多 以 及 多 对 一 关系 。 代 码 清 单 6-14 展 示 了 有 具体 的 实现 代码 ， 这 
些 代码 都 存储 在 一 个 名 为 store .go 的 文件 里 面 。 









































代码 清单 6-14 ”使 用 Go 语言 实现 一 对 多 以 及 多 对 一 关系 


package main 


import ( 
"database/sgl" 
"errors" 
"fmt" 
_ "github.com/lib/pq" 
) 


type Post struct ( 
Id int 
Content string 
Author string 
Comments []Comment 


} 


type Comment struct { 
Id int 
Content string 
Author string 
Post *Post 


j 


var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user-gwp dbname-gwp password-gwp 
e sslmode-disable") 


if err !- nil { 
panic(err) 
} 
} 
func (comment *Comment) Create() (err error) ( e 
if comment.Post -- nil { 
err - errors.New("Post not found") 
return 
j 


err - Db.QueryRow("insert into comments (content, author, post id) 
wvalues ($1, $2, $3) returning id", comment.Content, comment.Author, 
e comment.Post.Id).Scan(&comment.Id) 

return 


} 


func GetPost(id int) (post Post, err error) ( 
post = Posti) 
post.Comments - []Comment() 
err - Db.QueryRow("select id, content, author from posts where id - 


w$1", id).Scan(&post.Id, &post.Content, &post.Author) 


rows, err :- Db.Query("select id, content, author from comments") 
if err !- nil { 
return 
} 
for rows.Next() { 
comment := Comment{Post: &post} 
err = rows.Scan(&comment.Id, &comment.Content, &comment.Author) 
if err !- nil { 
return 
j 


post.Comments - append(post.Comments, comment) 


rows.Close() 
return 


} 


func (post *Post) Create() (err error) ( 
err - Db.QueryRow("insert into posts (content, author) values ($1, $2) 
wreturning id", post.Content, post.Author).Scan(&post.Id) 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
post.Create() 


comment :- Comment(Content: "Good post!", Author: "Joe", Post: &post) 
comment .Create() 
readPost, _ := GetPost(post.Id) e 


fmt.Println(readPost) 
fmt.Println(readPost.Comments) © 
fmt.Println(readPost.Comments[0O0].Post) e 
} 





O 创建 一 条 评论 
© {1 Hello World! Sau Sheong [(1 Good post! Joe 0xc20802a1c0)]) 


G [{1 Goodpost! Joe0xc20802a1c0] 


®© &(1 Hello World! Sau Sheong [(1 Good post! Joe 0xc20802a1c0)]) 


642 一 对 多 关系 


我 们 首先 需要 考虑 的 是 如 何 使 用 Post 和 Comment 这 两 个 结构 来 构 
建 一 对 多 关系 : 


type Post struct { 
Id int 
Content string 
Author string 
Comments []Comment 


} 


type Comment struct { 
Id int 
Content string 
Author string 
Post *Post 





注意 ，Post 结构 新 增 了 一 个 Comments 字段 ， 这 个 字段 是 一 个 由 任 
意 多 个 Comment 结构 组 成 的 切片 ， 与 此 同时 ，Comment 结构 也 新 增 了 一 
个 Post 字段 ， 这 个 字段 是 一 个 指向 Post 结构 的 指针 。 初 看 上 去 ， 程 序 
似乎 会 把 多 个 Comment 结构 存储 到 一 个 Post 结构 里 面 ， 然 后 让 
Comment 结构 通过 指针 引用 Post 结构 。 但 是 实际 上 ， 因 为 切片 也 是 一 
个 指 问 数组 的 指针 ， 所 以 Post 结构 和 Comment 结构 在 构建 关系 时 使 用 
的 都 是 指针 : 这 种 做 法 可 以 确保 程序 获取 到 的 都 是 同一 个 Post 结构 或 
者 Comment 结构 ， 而 不 是 这 些 结构 的 副本 。 





在 设 定好 Post 结构 和 Comment 结构 之 间 的 关系 之 后 ， 我 们 接 下 来 
要 考虑 的 就 是 如 何 实际 地 构建 这 些 关 系 。 正 如 前 面 所 说 ， 一 对 多 关系 实 


际 上 就 是 多 对 一 关系 ， 所 以 这 两 个 结构 在 定义 一 对 多 关系 的 同时 ， 也 害 
义 了 多 对 一 关系 。 当 程序 创建 一 条 新 评论 的 时 候 ， 它 就 会 在 评论 和 被 评 
论 的 帖子 之 间 建 并 起 以 上 提 到 的 这 两 种 关系 : 


comment := Comment{Content: "Good post!", Author: "Joe", Post: &post} 


comment.Create() 





跟 之 前 的 做 法 一 样 ， 程 序 首先 会 创建 一 个 Comment 结构 ， 然 后 通过 
调用 该 结构 的 Create 方法 来 创建 评论 ， 并 藉 此 建立 起 评论 与 帖子 之 间 
的 关系 。 代 码 清单 6-15 展 示 了 Comment 结构 的 Create 方法 的 具体 定 
po 

















代码 清单 6-15 ”创建 评论 ， 并 建立 评论 与 帖子 之 间 的 关系 








func (comment *Comment) Create() (err error) ( 
if comment.Post == nil ( 
err - errors.New("Post not found") 
return 


} 


err = Db.QueryRow("insert into comments (content, author, post id) 
wvalues ($1, $2, $3) returning id", comment.Content, comment.Author, 
e comment.Post.Id).Scan(&comment.Id) 

return 








在 为 评论 和 帖子 建立 关系 之 前 ，Create 方法 会 先 检 查 给 定 的 帖子 
是 否 存 在 ， 并 在 帖子 不 存在 时 返回 一 个 错误 。 除 了 “通过 post_id 建立 
关系 ”这 一 细节 没有 提 及 之 外 ，Create 方法 的 其 余 代码 的 行为 跟 我 们 之 
前 描述 的 一 模 一 样 。 


在 建立 起 评论 和 帖子 之 间 的 关系 之 后 ， 我 们 接 下 来 要 考虑 的 就 是 如 








何 修改 GetPost 函数 ， 让 它 可 以 在 获取 帖子 的 同时 ， 一 并 获取 与 帖子 相 
关联 的 评论 。 比 如 说 ， 程 序 在 执行 完 以 下 代码 之 后 ， 应 该 可 以 通过 访问 
readPost 变量 的 Comments 字段 来 查看 帖子 已 有 的 评论 : 


readPost, _ := GetPost(post.Id) 


代码 清单 6-16 展 示 了 修改 之 后 的 GetPost 函数 的 定义 。 























代码 清单 6-16 ”获取 帖子 及 其 评论 




















func GetPost(id int) (post Post, err error) ( 
post = Posti) 
post.Comments = []Comment() 
err - Db.QueryRow("select id, content, author from posts where id - 
w$1", id).Scan(&post.Id, &post.Content, &post.Author) 


rows, err :- Db.Query("select id, content, author from comments where 
wpost id = $1", id) 
if err != nil { 
return 
} 
for rows.Next() { 
comment := Comment{Post: &post} 
err = rows.Scan(&comment.Id, &comment.Content, &comment.Author) 
if err != nil { 
return 
} 


post.Comments = append(post.Comments, comment) 


rows.Close() 
return 





GetPost 函数 首先 会 初始 化 Post 结构 中 的 Comments 字段 ， 并 从 数 
据 库 里 面 获取 帖子 的 具体 数据 。 在 此 之 后 ， 程 序 会 从 数据 库 里 面 获取 与 
当前 帖子 关联 的 所 有 评论 ， 接 着 欠 代 这 些 评 论 ， 为 每 个 评论 都 创建 一 





个 Comment 结构 并 将 其 追加 到 Comments 切片 里 面 。 当 所 有 评论 都 被 迭 
代 完 毕 之 后 ，GetPost 函数 就 会 将 包含 了 评论 的 Post 结构 返回 给 调用 
者 。 正 如 上 述 内 容 所 示 ， 在 多 个 表 之 间 建 立 关 系 并 不 困难 ， 但 是 这 一 行 
为 在 web 应 用 变 得 越 来 越 庞 大 的 同时 就 会 变 得 越 来 越 麻烦 。 为 了 解决 这 
个 问题 ， 我 们 将 在 接 下 来 的 一 节 中 学 习 如 何 通过 关系 映射 器 来 简化 关系 
的 构建 方法 。 








虽然 本 节 展 示 了 所 有 数据 库 应 用 都 会 用 到 的 CRUD 操 作 ， 但 这 些 操 
作 充 其 量 只 是 使 用 Go 访问 SQL 数据 库 的 基本 知识 ， 如 果 你 有 兴趣 了解 更 
多 相关 的 知识 ， 那 么 可 以 去 读 一 下 Go 的 官方 文档 。 


6.5 Go 与 关系 映射 人 右 


初 看 上 去 ， 将 数据 存储 到 关系 数据 库 里 面 似乎 并 不 是 一 件 轻松 的 事 
情 ， 有 非常 多 的 工作 要 做 。 对 不 少 语言 来 说 ， 这 一 判断 是 正确 的 ， 然 而 
在 实际 中 ，SQL 与 应 用 之 间 通 常 存在 着 一 些 第 三 方 库 ， 这 些 库 在 面 同 对 
象 编程 语言 中 一 般 称 为 对 象 -关系 映射 器 Cobject-relational mapper, 
ORM) 。 诸 如 Java 的 Hibernate 以 及 Ruby 的 ActiveRecord 之 类 的 ORM 都 会 
把 关系 数据 库 中 的 表 映 射 为 编程 语言 中 的 对 象 ， 但 为 表 创 建 映射 并 不 是 
面向 对 象 编程 语言 的 特权 ， 很 多 其 他 编程 语言 也 拥有 类 似 的 映射 器 ， 比 
如 ，Scala 有 Activate 框 架 ，Haskellj 有 Groundhog 库 。 





Go 同样 也 拥有 类 似 的 关系 映射 器 (relational mapper) ， 本 节 接 下 
来 将 介绍 其 中 一 些 映 射 器 (因为 ORM 这 一 术语 对 于 Go 来 说 并 不 是 特别 
准确 ， 所 以 我 们 将 使 用 “关系 映射 器 ”而 不 是 “ORM” 来 称呼 接 下 来 提 到 的 
Go 映射 嚣 〉。 


6.5.1 Sqlx 


Sqlx 是 一 个 第 三 方 库 ， 它 为 database/sql 包 提 供 了 一 系列 非常 有 
用 的 扩展 功能 。 因 为 Sglx 和 database/sql 包 使 用 的 是 相同 的 接口 ， 所 
以 Sqlx 能 够 很 好 地 兼容 使 用 database/sql 包 的 程序 ， 除 此 之 外 ，Sqlx 
还 提供 了 以 下 这 些 额外 的 功能 : 





e 通过 结构 标签 Cstructtag) 将 数据 库 记 录 《〈 即 行 ) 封装 为 结构 、 映 
WREAU; 
。 为 预 处 理 语句 提供 具名 参数 文 持 。 


代码 清单 6-17 展 示 了 如 何 使 用 Sqlx 及 其 提供 的 Structscan 方法 来 
对 论坛 程序 进行 简化 。 另 外 别 筷 了 ， 在 使 用 Sqlx 库 之 前 ， 需 要 先 通过 执 
行 以 下 命令 来 获取 这 个 库 : 


go get "github.com/jmoiron/sqlx" 


代码 清单 6-17 使 用 Sqlx 重新 实现 论坛 程序 




















package main 


"github.com/jmoiron/sqlx" 


_ "github.com/lib/pq" 
) 


type Post struct ( 
Id int 
Content string 
AuthorName string db: author^ 


} 


var Db *sqlx.DB 


func init() { 
var err error 
Db, err = sqlx.Open("postgres", "user-gwp dbname-gwp password-gwp 


e sslmode-disable") 


if err != nil { 
panic(err) 
} 
} 


func GetPost(id int) (post Post, err error) ( 
post = Posti) 
err - Db.QueryRowx("select id, content, author from posts where id - 


w$1", id).StructScan(&post) 


if err != nil { 
return 
} 


return 


} 


func (post *Post) Create() (err error) ( 
err - Db.QueryRow("insert into posts (content, author) values ($1, $2) 
wreturning id", post.Content, post.AuthorName).Scan(&post.Id) 
return 


} 


func main() { 
post := Post{Content: "Hello World!", AuthorName: "Sau Sheong"} 
post.Create() 
fmt.Println(post) e 





@ (1 Hello World! Sau Sheong}} 


代码 清单 中 的 加 粗 代 码 展示 了 使 用 Sqlx 与 使 用 database/sql 之 间 
的 区 别 ， 而 其 余 的 则 是 一 些 我 们 之 前 已 经 看 到 过 的 代码 。 首 先 ， 程 序 现 
在 不 再 导入 database/sql 包 ， 而 是 导入 github.com/jmoiron/sqlx 
包 。 在 默认 情况 下 ，StructScan 会 根据 结构 字段 名 的 英文 小 写 体 ， 将 
结构 中 的 字段 映射 至 表 中 的 列 。 为 了 演示 如 何 将 指定 的 表 列 映射 至 指定 
的 结构 字段 ， 代 码 清单 6-17 将 原来 的 Author 字段 修改 成 了 AuthorName 
字段 ， 然 后 通过 结构 标签 来 指示 Sqlx 应 该 从 author 列 里 面 获 取 
AuthorName 字段 的 数据 。 本 书 将 在 第 7 章 对 结构 标签 做 进一步 的 说 
明 。 

















程序 现在 也 会 使 用 sqlx.DB 结构 来 代替 之 前 的 sql.DB 结构 ， 这 两 
种 结构 非常 相似 ， 只 不 过 sqlx.DB 包含 了 诸如 Queryx 以 及 QueryRowx 
等 额外 的 方法 。 


修改 之 后 的 GetPost 函数 也 使 用 QueryRowx 代替 了 之 前 的 
QueryRow 。QueryRowx 在 执行 之 后 将 返回 Rowx 结构 ， 这 种 结构 拥 
fjstructScan 方法 ， 该 方法 可 以 将 列 上 自动 地 映射 到 相应 的 字段 里 面 。 
另 一 方面 ， 对 于 Create 方法 ， 我 们 还 是 跟 之 前 一 样 ， 使 用 QueryRow 7; 
法 进行 查询 。 

除了 这 里 提 到 的 特性 之 外 ，Sqlx 还 拥有 其 他 一 些 有 趣 的 特性 ， 感 兴 
趣 的 读者 可 以 通过 访问 Sqlx 的 GitHub 页 面 来 了 解 : 
https://github.com/jmoiron/sqlx. 


Sqlx 是 一 个 有 趣 并 且 有 用 的 database/sql 扩展 ， 但 它 支持 的 特性 





并 不 多 。 与 此 相反 ， 我 们 接 下 来 要 学 习 的 Gorm 库 不 仅 把 database/sq1l1 
包 隐 藏 了 起 来 ， 它 还 提供 了 一 个 完整 且 强 大 的 ORM 机 制 来 代 蔡 
database/sql 包 。 


6.5.2 Gorm 


Gorm 的 开发 者 声称 Gorm 是 最 棒 的 Go 语言 ORM， 他 们 的 确 所 言 非 
虚 。Gorm 是 “Go-ORM" 一 词 的 缩写 ， 这 个 项 目 是 一 个 使 用 Go 实现 的 
ORM， 它 遵循 的 是 与 Ruby 的 ActiveRecord 以 及 Java 的 Hibernate 一 样 的 道 
路 。 更 确切 地 说 ，Gorm 遵 循 的 是 数据 映射 句 模 式 〈Data-Mapper 
pattern) ， 该 模式 通过 提供 映射 器 来 将 数据 库 中 的 数据 映射 为 结构 。 
(在 6.3 节 介绍 关系 数据 库 时 ， 使 用 的 就 是 ActiveRecord 模 式 。) 


Gorm 的 能 力 非 第 强大 ， 它 允许 程序 员 定义 关系 、 实 施 数据 迁移 、 
串联 多 个 碍 询 以 及 执行 其 他 很 多 高 级 的 操作 。 除 此 之 外 ，Gorm 还 能 够 
设置 回调 函数 ， 这 些 函 数 可 以 在 特定 的 数据 事件 发 生 时 执行 。 因 为 详尽 
地 描述 Gorm 的 各 个 特性 可 能 会 花 挥 整整 一 章 的 篇 幅 ， 所 以 我 们 在 这 里 
只 会 讨论 它 的 基本 特性 。 代 码 清单 6-18 展 示 了 使 用 Gorm 重 新 实现 论坛 程 
序 的 方法 ， 跟 之 前 一 样 ， 这 次 的 代码 也 是 存储 在 store .go 文件 里 面 。 











代码 清单 6-18 ”使 用 Gorm 实 现 论坛 程序 











package main 


import ( 
"fmt" 
"github.com/jinzhu/gorm" 
_ "github.com/lib/pq" 
"time" 


) 


type Post struct { 


Id int 

Content string 

Author string 'sql:"not null" 
Comments  []Comment 

CreatedAt time.Time 


} 


type Comment struct { 
Id int 
Content string 
Author string 'sql:"not null" 
PostId int ^sql:"index'"" 
CreatedAt time.Time 


} 


var Db gorm.DB 


func init() { 
var err error 
Db, err = gorm.Open("postgres", "user-gwp dbname-gwp password-gwp 
e sslmode-disable") 
if err != nil { 
panic(err) 
} 
Db.AutoMigrate(&Post{}, &Comment{}) 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong") e 
fmt.Println(post) 


Db.Create(&post) e 
fmt.Println(post) e 


comment := Comment(Content: "Good post!", Author: "Joe") e 
Db.Model(&post).Association("Comments").Append(comment ) 


var readPost Post 
Db.Where("author - $1", "Sau Sheong").First(&readPost) e 
var comments []Comment 
Db.Model(&readPost).Related(&comments) 
fmt.Println(comments[0]) e 
} 





@ {0 Hello World! Sau Sheong [] 0001-01-01 00:00:00 +0000 UTC} 


e 创建 一 篇 帖子 


@ {1 Hello World! Sau Sheong [] 2015-04-12 11:38:50.91815604 
*0800 SGT} 


€ 添加 一 条 评论 
Q 通过 帖子 获取 评论 
Q {1 Good post! Joe 1 2015-04-13 11:38:50.920377 +0800 SGT} 


这 个 新 程序 创建 数据 库 句 柄 的 方法 跟 我 们 之 前 创建 数据 库 句 柄 的 方 
法 基本 相同 。 男 外 需要 注意 的 一 点 是 ， 因 为 Gorm 可 以 通过 目 动 数据 迁 
移 特性 来 创建 所 需 的 数据 库 表 ， 并 在 用 户 修改 相应 的 结构 时 自动 对 数据 
库 表 进 行 更 新 ， 所 以 这 个 程序 无 需 使 用 setup.sq1 文件 来 设置 数据 库 
R: 当 我 们 运行 这 个 程序 时 ， 程 序 所 需 的 数据 库 表 就 会 目 动 生成 。 为 了 
正确 地 运行 这 个 程序 ， 并 让 程序 能 够 正常 地 创建 数据 库 表 ， 我 们 在 执行 
这 个 程序 之 前 必须 先 将 之 前 创建 的 数据 库 表 全 部 删除 : 











func init() { 

var err error 

Db, err = gorm.Open("postgres", "user-gwp dbname-gwp password-gwp sslm 
ode-disable") 


panic(err) 


Db.AutoMigrate(&Post(), &Comment()) 
} 





负责 执行 数据 迁移 操作 的 AutoMigrate 方法 是 一 个 变 长 参数 方 
法 ， 这 种 类 型 的 方法 和 函数 能 够 接受 一 个 或 多 个 参数 作为 输入 。 在 上 面 





展示 的 代码 中 ，AutoMigrate 方法 接受 的 是 Post 结构 和 Comment £i 
构 。 得 益 于 自动 数据 迁移 特性 的 存在 ， 当 用 户 向 结构 里 面 添加 新 字段 的 
时 候 ，Gorm 就 会 自动 在 数据 库 表 里 面 添加 相应 的 新 列 。 





上 面 的 Gorm 程 序 使 用 了 下 面 所 示 的 Comment 结构 : 


type Comment struct { 
Id int 


Content string 
Author string 'sql:"not null" 


PostId int 
CreatedAt time.Time 





Comment 结构 里 面 出 现 了 一 个 类 型 为 time.Time 的 CreatedAt 字 
段 ， 包 含 这 样 一 个 字段 意味 着 Gorm 每 次 在 数据 库 里 创建 一 条 新 记录 的 
时 候 ， 都 会 自动 对 这 个 字段 进行 设置 。 


此 外 ，Comment 结构 的 其 中 一 些 字段 还 用 到 了 结构 标签 ， 以 此 来 指 
示 Gorm 应 该 如 何 创建 和 映射 相应 的 字段 。 比 如 ，Comment 结构 的 
Author 字段 就 使 用 了 结构 标签 'sql: "not null"' , 以 此 来 告知 
Gorm， 该 字段 对 应 列 的 值 不 能 为 null 。 


跟前 面 展示 过 的 程序 的 男 一 个 不 同 之 处 在 于 ， 这 个 程序 没有 
在 Comment 结构 里 设置 Post 字段 ， 而 是 设置 了 一 个 PostId FR. 
Gorm 会 自动 把 这 种 格式 的 字段 看 作 是 外 键 ， 并 创建 所 需 的 关系 。 


在 了 解 了 Post 结构 和 Comment 结构 的 新 定义 之 后 ， 现 在 ， 让 我 们 
来 看 看 程序 是 如 何 创建 并 获取 帖子 及 其 评论 的 。 首 先 ， 程 序 会 使 用 以 下 
语句 来 创建 新 的 帖子 : 





post := Post(Content: "Hello World!", Author: "Sau Sheong") 
Db.Create(&post) 











这 段 代 码 没 有 什么 难民 的 地 方 ， 它 跟 之 前 展示 过 的 代码 的 最 主要 区 
列 在 于 一 一 程序 这 次 遵循 了 数据 映射 右 模 式 : 它 在 创建 帖子 时 会 使 用 数 
据 库 句 柄 gorm.DB 作为 构造 器 ， 而 不 是 像 之 前 遵循 ActiveRecord 模 式 时 
那样 ， 通 过 直接 调用 Post 结构 自 有 的 Create 方法 来 创建 帖子 。 





如 果 直 接 查 看 数据 库 内 部 ， 应 该 会 看 到 created at 这 个 时 间 惟 列 
在 帖子 创建 出 来 的 同时 已 经 自动 被 设置 好 了 。 





在 创建 出 帖子 之 后 ， 程 序 使 用 了 以 下 语句 来 为 帖子 添加 评论 : 


comment := Comment{Content: "Good post!", Author: "Joe"} 


Db.Model(&post).Association("Comments").Append(comment) 





这 段 代 码 会 先 创 建 出 一 条 评论 ， 然 后 通过 串联 Model 方 
ik. Association 方法 和 Append 方法 来 将 评论 添加 到 帖子 里 面 。 注 
意 ， 在 创建 评论 的 过 程 中 ， 我 们 无 需 手 动 对 Comment 结构 的 PostId 字 
段 执 行 任何 操作 。 


最 后 ， 程 序 使 用 了 以 下 代码 来 获取 帖子 及 其 评论 : 


var readPost Post 
Db.Where("author = $1", "Sau Sheong").First(&readPost) 


var comments []Comment 
Db.Model(&readPost).Related(&comments) 





这 上 段 代码 跟 之 前 展示 过 的 代码 有 些 类 似 ， 它 使 用 了 gorm.DB 的 


Where 方法 来 查找 第 一 条 作者 名 为 "Sau Sheong" 的 记录 ， 并 将 这 条 记 
录 存 储 在 了 readPost 变量 里 面 ， 而 这 条 记录 就 是 我 们 刚刚 创建 的 帖 
子 。 之 后 ， 程 序 首先 调用 Model 方法 获取 帖子 的 模型 ， 接 着 调 

用 Related 方法 获取 帖子 的 评论 ， 并 在 最 后 将 这 些 评论 存储 

到 comments 变量 里 面 。 





正如 之 前 所 说 ， 本 节 展 示 的 特性 只 是 Gorm 这 个 ORM 库 众多 特性 的 
一 小 部 分 ， 如 果 你 对 这 个 库 感 兴趣 ， 可 以 通过 
https://github.com/jinzhu/gorm 了解 更 多 相关 信息 。 


Gorm 并 不 是 Go 语言 唯一 的 ORM 库 。 除 Gorm 之 外 ，Go 还 拥有 不 少 
同样 具备 众多 特性 的 ORM 库 ， 比 如 ，Beego 的 ORM 库 以 及 
GORP (GORP 并 不 完全 是 一 个 ORM， 但 它 与 ORM 相 去 不 远 ) 。 


在 本 章 中 ， 我 们 了 解 了 构建 Web 应 用 所 需 的 基本 组 件 ， 而 在 接 下 来 
的 一 章 中 ， 我 们 将 要 开始 讨论 如 何 构建 Web 服 务 。 


6.6 小结 


。 通过 使 用 结构 将 数据 存储 在 内 存 里 面 ， 以 此 来 构建 数据 缓存 机 制 并 
提高 响应 速度 。 

。 通过 使 用 CSV 或 者 gob 二 进 制 格 式 将 数据 存储 在 文件 里 面 ， 可 以 对 
用 户 提交 的 文件 进行 处 理 ， 或 者 为 缓存 数据 提供 备份 。 

e 通过 使 用 database/sql 包 ， 可 以 对 关系 数据 库 执 行 CRUD 操 作 ， 
并 在 不 同 的 数据 之 间 建 立 起 相应 的 关系 。 

。 通过 Sqlx 和 Gorm 这 样 的 第 三 方 数据 访问 库 ， 可 以 使 用 威力 更 强大 的 








工具 去 操纵 数据 库 中 的 数据 。 





[1] 有 序 关机 指 的 是 等 到 所 有 任务 都 执行 完毕 之 后 ， 以 有 组 织 的 方式 关 
闭 计算 机 系统 ， 这 种 关机 可 以 确保 系统 在 重启 之 后 不 会 丢失 任何 进度 或 
者 数据 。 译 者 注 








第 二 部 分 ”实战 演练 


在 上 一 个 部 分 ， 我 们 学 习 了 如 何 编写 基本 的 服务 器 端 Web 应 用 ， 但 
这 些 知识 只 不 过 是 Web 应 用 开发 中 的 沧海 一 桶 。 绝 大 多 数 现代 化 的 Web 
应 用 早已 超越 了 简单 的 请 求 - 啊 应 模型 ， 并 以 多 种 不 同 的 形式 在 不 断 地 
演进 当中 。 比 如 ， 单 页 应 用 〈Single Page Application, SPA) 和 移动 应 
用 (无论 是 原生 的 还 是 混合 的 ) 就 能 够 在 获取 Web 服 务 中 的 数据 的 同 
时 ， 人 快速 地 与 用 户 进行 交互 。 





在 本 书 的 最 后 一 部 分 ， 我 们 将 会 学 习 如 何 使 用 Go 语言 编写 能 够 为 
单 页 应 用 、 移 动 应 用 以 及 其 他 Web 应 用 提供 服务 的 Web 服 务 。 除 此 之 
外 ， 我 们 还 会 深入 了 解 Go 语言 强大 的 并 发 特性 ， 并 学 习 如 何 通过 并 发 
提高 Web 应 用 的 性 能 。 之 后 ， 我 们 会 了 解 Go 提供 的 几 个 测试 工具 ， 并 使 
用 这 些 工 具 对 Web 应 用 进行 测试 。 


在 本 书 的 最 后 ， 我 们 将 会 学 习 如 何以 多 种 不 同 的 方式 部 普 Web 应 
用 ， 其 中 包括 只 需要 将 可 执行 二 进 制 文件 复制 到 目标 服务 器 的 简单 部 闭 
方法 ， 以 及 需要 执行 一 系列 步骤 才能 将 Web 应 用 推送 到 云端 的 高 级 部 普 
Ank. 





第 7 音 | Go Web 服 务 


本 章 主要 内 容 


。 使 用 REST 风 格 的 Web 服 务 
。 使 用 Go 创建 和 分 析 XML 
。 使 用 Go 创建 和 分 析 JSON 
。 编写 Go Web 服 务 


正如 本 书 第 1 章 所 言 ，Web 服 务 就 是 一 个 向 其 他 软件 程序 提供 服务 
的 程序 。 本 章 将 扩展 这 一 定义 ， 并 展示 如 何 使 用 Go 语言 来 编写 或 使 用 
Web 服 务 。 因 为 XML 和 JSON 是 Web 服务 最 常 使 用 的 数据 格式 ， 所 以 我 
们 首先 会 学 习 如 何 创 建 以 及 分 析 这 两 种 数据 格式 ， 接 着 我 们 将 会 讨论 
SOAP 风 格 的 服务 以 及 REST 风 格 的 服务 ， 并 在 之 后 学 习 如 何 创建 一 个 使 
用 JSON 传 输 数 据 的 简单 的 Web 服 务 。 


7.1 Web 服 务 简介 


通过 Go 语言 编写 的 Web 服 务 辐 其 他 Web 服 务 或 应 用 提供 服务 和 数 
据 ， 是 Go 语言 的 一 种 第 见 的 用 法 。 所 谓 的 Web 服 务 ， 一 言 以 蔽 之 ， 就 是 
一 种 与 其 他 软件 程序 进行 交互 的 软件 程序 。 这 也 惑 是 说 ，Web 服 务 的 终 
端 用 户 〈end user) 不 是 人 类 ， 而 是 软件 程序 。 正 如 “Web 服 务 ” 这 一 名 字 
所 晓 示 的 那样 ， 这 种 软件 程序 是 通过 HTTP 进 行 通信 的 ， 如 图 7-1 所 示 。 





用 户 浏览 器 Web 应 用 


Web 应 用 Web 服 务 


图 7-1 Web 应 用 与 Web 服 务 的 不 同 之 处 


有 趣 的 是 ， 虽 然 web 应 用 并 没有 一 个 确切 的 定义 ， 但 Web 服 务 的 定 
义 却 可 以 在 W3C 工 作 组 发 布 的 《Web 服 务 架 构 》 (Web Service 
Architecture) 文档 中 找到 : 





Web 服 务 是 一 个 软件 系统 ， 它 的 目的 是 为 网 络 上 进行 的 可 互 操作 机 器 间 
交互 Cinteroperable machine-to-machine interaction). 提供 支持 。 每 个 Web 服 务 


都 拥有 一 套 自己 的 接口 ， 这 些 接口 由 一 种 名 为 Web 服 务 描述 语言 (web 

















service description language, WSDL) 的 机 器 可 处 理 格式 描述 。 其 他 系统 需 





要 根据 Web 服 务 的 描述 ， 使 用 SOAP 消 息 与 Web 服 务 交 互 。 为 了 与 其 他 Web 
相关 标准 实现 协作 ，SOAP 消 息 通常 会 被 序列 化 为 XML 并 通过 HTTP 传 输 。 























一 - 《Web 服务 架构 》，2004 年 2 月 11 日 





从 这 一 定义 来 看 ， 似 乎 所 有 Web 服 务 都 应 该 基于 SOAP 来 实现 ， 但 
实际 中 却 存在 着 多 种 不 同类 型 的 Web 服 务 ， 其 中 包括 基于 SOAP 的 、 基 
于 REST 的 以 及 基于 XML-RPC 的 ， 而 基于 REST 的 和 基于 SOAP 的 Web 服 
务 又 是 其 中 最 为 流行 的 。 企 业 级 系统 大 多 数 都 是 基于 SOAP 的 Web 服 务 
实现 的 ， 而 公开 可 访问 的 Web 服 务 则 更 青睐 基于 REST 的 Web 服 务 ， 本 
章 稍 后 将 会 对 此 进行 讨论 。 








基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 都 能 够 完成 相同 的 功 
能 ， 但 它们 各 自 也 拥有 不 同 的 长 处 。 基 于 SOAP 的 Web 服 务 出 现 的 时 间 
较 早 ，W3C 工 作 组 已 经 对 其 进行 了 标准 化 ， 与 之 相关 的 文档 和 资料 也 非 
党 丰富 。 除 此 之 外 ， 很 多 企业 都 对 基于 SOAP 的 Web 服 务 提 供 了 强 有 力 
的 文 持 ， 并 且 基 于 SOAP 的 Web 服 务 还 拥有 数量 颇 丰 的 扩展 可 用 《因为 
这 些 扩展 的 名 字 绝 大 多 数 都 是 像 WS-Security 和 WS-Addressing 这 样 以 WS 
为 前 级 的 ， 所 以 这 些 扩展 被 统称 为 WS-*) 。 基 于 SOAP 的 服务 不 仅 健 
壮 、 能 够 使 用 WSDL 进 行 明确 的 描述 、 拥 有 内 置 的 错误 处 理 机 制 ， 而 且 
还 可 以 通过 UUDI (Universal Description, Discovery, and Integration， 统 
一 描述 、 发 现 和 集成 ) (一 种 目录 服务 〉 规范 发 布 。 














在 拥有 以 上 众多 优点 的 同时 ，SOAP 的 缺点 也 是 非常 明显 的 : 它 不 
仅 笨重 ， 而 且 过 于 复杂 。SOAP 的 XML 报 文 可 能 会 变 得 非常 元 长 ， 导 致 
难以 调试 ， 使 用 户 只 能 通过 其 他 工具 对 其 进行 管理 ， 而 基于 SOAP 的 
Web 服 务 可 能 会 因为 额外 的 资源 损耗 而 无 法 高 效 地 运行 。 此 外 ，WSDL 


虽然 在 客户 端 和 服务 器 之 间 提 供 了 坚实 的 契约 ， 但 这 种 契约 有 时 候 也 会 
变 成 一 种 累 袭 : 为 了 对 Web 服 务 进行 更 新 ， 用 户 必须 修改 WSDL， 而 这 
种 修改 又 会 引起 SOAP 客 户 端 发 生变 化 ， 最 终 导 致 Web 服 务 的 开发 者 即 
使 在 进行 最 细微 的 修改 时 ， 也 不 得 不 使 用 版 本 锁定 (version lock-in) 以 
防止 发 生意 外 。 


跟 基 于 SOAP 的 Web 服 务 比 起 来 ， 基 于 REST 的 Web 服 务 就 显得 灵活 
多 了 。REST 本 身 并 不 是 一 种 结构 ， 而 是 一 种 设计 理念 。 很 多 基于 REST 
的 Web 服 务 都 会 使 用 像 JSON 这 样 较为 简单 的 数据 格式 而 不 是 XML， 从 
而 使 Web 服 务 可 以 更 高 效 地 运行 ， 并 且 基 于 REST 的 Web 服 务实 现 起 来 
通常 会 比 基 于 SOAP 的 Web 服 务 简 单 得 多 。 


基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 的 另 一 个 区 别 在 于 ， 
前 者 是 功能 驱动 的 ， 而 后 者 是 数据 驱动 的 。 基 于 SOAP 的 Web 服 务 往往 
是 RPC (Remote Procedure Call， 远 程 过 程 调 用 ) 风格 的 ; 但 是 ， 正 如 
之 前 所 说 ， 基 于 REST 的 Web 服 务 关 注 的 是 资源 ， 而 HTTP 方 法 则 是 对 这 
些 资 源 执行 操作 的 动词 。 





ProgrammableWeb 是 一 个 流行 的 API 检 测 网 站 ， 它 会 对 互联 网 上 公 
开 可 用 的 API 进 行 检 测 。 在 编写 本 书 的 时 候 ，ProgrammableWeb 的 数据 
库 搜集 了 12 987 个 公开 可 用 的 API， 其 中 2 061 个 ( 占 比 16%) 为 基于 
SOAP 的 API， 而 6 967 个 “〈 占 比 54%) 为 基于 REST 的 API H 。 可 惜 的 
是 ， 因 为 企业 很 少 会 对 外 发 布 与 内 部 Web 服 务 有 关 的 信息 ， 所 以 想 要 调 
查 清楚 各 种 Web 服 务 在 企业 中 的 使 用 情况 是 非常 困难 的 。 








为 了 满足 不 同 的 需求 ， 很 多 开发 者 和 公司 最 终 还 是 会 同时 使 用 基于 
SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 。 在 这 种 情况 下 ，SOAP 将 用 


于 实现 内 部 应 用 的 企业 集成 (enterprise integration? ， 而 REST 则 用 于 服 
务 外 部 以 及 第 三 方 的 开发 者 。 这 一 策略 的 优势 在 于 ， 它 最 大 限度 地 利用 
了 REST〔 速 度 快 并 且 构 建 简单 ) 以 及 SOAP〔 安 全 并 且 健 壮 ) 这 两 种 技 
术 的 优点 。 


7.2 基于 SOAP 的 Web 服 务 简 介 


SOAP 是 一 种 协议 ， 用 于 交换 定义 在 XML 里 面 的 结构 化 数据 ， 它 能 
够 跨越 不 同 的 网 络 协议 并 在 不 同 的 编程 模型 中 使 用 。SOAP 原 本 是 
Simple Object Access Protocol( 人 简单 对 象 访问 协议 ) 的 首 字 母 缩写 ， 但 
这 实际 上 是 一 个 名 不 符 实 的 名 字 ， 因 为 这 种 协议 处 理 的 并 不 是 对 象 ， 并 
且 时 至 今日 它 也 已 经 不 再 是 一 种 简单 的 协议 了 。 在 最 新 版 的 SOAP 1.2 规 
范 中 ， 这 种 协议 的 官方 名 称 仍然 为 OAP， 但 它 已 经 不 再 代表 Simple 
Object Access Protocol 了 。 











因为 SOAP 不 仅 高 度 结构 化 ， 而 且 还 需要 严格 地 进行 定义 ， 所 以 用 
于 传输 数据 的 XML 可 能 会 变 得 非常 复 灯 。WSDL 是 客户 端 与 服务 器 之 间 
的 契约 ， 它 定义 了 服务 提供 的 功能 以 及 提供 这 些 功 能 的 方式 ， 服 务 的 每 
个 操作 以 及 输入 /输出 都 需要 由 WSDL 明 确 地 定义 。 





虽然 本 章 主 要 关注 的 是 基于 REST 的 Web 服 务 ， 但 出 于 对 比 需 要 ， 
我 们 也 会 了 解 一 下 基于 SOAP 的 Web 服 务 的 运作 机 制 。 





SOAP 会 将 它 的 报 文 内 容 放 入 到 信封 Cenvelope) 里 面 ， 信 封 相 当 于 
一 个 运输 容 吉 ， 并 且 它 还 能 够 独立 于 实际 的 数据 传输 方式 存在 。 因 为 本 
书 只 会 对 SOAP Web 服 务 进行 考察 ， 所 以 我 们 将 通过 HTTP 协 议 来 说 明 被 





传输 的 SOAP 报 文 。 


下 面 是 一 个 经 过 简化 的 SOAP 请 求 报 文 示例 : 


POST /GetComment HTTP/1.1 
Host: www.chitchat.com 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap:Envelope 
xmlns:soapz"http://www.w3.0rg/2001/12/soap-envelope" 
soap:encodingStyle-"http://www.w3.0rg/2001/12/soap-encoding"» 
«soap:Body xmlns:m-"http://www.chitchat.com/forum"» 

«m:GetCommentRequest» 

«m: ComnentId»123«/m:CommentId» 

«/m:GetCommentRequest » 
«/soap:Body» 
«/soap:Envelope» 





因为 前 面 已 经 介绍 过 HTTP 报 文 的 首部 ， 所 以 这 里 给 出 的 HITP 首 部 
对 你 来 说 应 该 不 会 感到 陌生 。 需 要 注意 的 是 ，Content-Type 的 值 被 设 
置 成 了 application/soap+xml] ， 而 HITP 请 求 的 主体 就 是 SOAP 报 文 
本 号 ， 至 于 SOAP 报 文 的 主体 则 包含 了 请 求 报 文 。 在 这 个 例子 中 ， 报 文 
请 求 的 是 D 为 123 的 评论 : 











<m:GetCommentRequest> 
<m:CommentId>123</m:CommentId> 
</m:GetCommentRequest > 








这 条 SOAP 报 文 示例 经 过 了 简化 ， 实 际 的 SOAP 请 求 通常 会 复杂 得 
多 。 下 面 展示 的 则 是 一 条 简化 后 的 SOAP 响 应 报 文 示例 : 








HTTP/1.1 200 OK 
Content-Type: application/soaperxml; charset-utf-8 


<?xml version="1.0"?> 
<soap:Envelope 
xmlns:soapz"http://www.w3.0rg/2001/12/soap-envelope" 
soap:encodingStyle-"http://www.w3.0rg/2001/12/soap-encoding"» 
«soap:Body xmlns:mz"http://www.example.org/stock"» 

«m:GetCommentResponse» 

«m:Text»Hello World!«/m:Text» 

«/m:GetCommentResponse» 
«/soap:Body» 
«/soap:Envelope» 





跟 请 求 报 文 一 样 ， 啊 应 报 文 也 被 包含 在 了 SOAP 报 文 的 主体 里 面 ， 
它 的 内 容 为 文本 “Hello World: 


<m:GetCommentResponse> 
«m:Text»Hello World!«/m:Text» 


«/m:GetCommentResponse» 





正如 上 面 的 例子 所 示 ， SOME 关 的 所 有 数据 都 会 被 包含 在 信封 里 
面 。 对 基于 SOAP 的 Web 服 务 来 说 ， 这 意味 着 它 传输 的 所 有 信息 都 会 被 
包 正 在 SOAP 信 封 里 面 ， 然 后 再 发 送 。 顺 带 一 提 ， 虽 然 SOAP 1.2 人 允许 通 
过 HTTP 的 GET 方法 发 送 SOAP 报 文 ， 但 大 多 数 基于 SOAP 的 Web 服 务 都 
是 通过 HTTP 的 POST 方法 发 送 SOAP 报 文 的 。 





下 面 展示 的 是 一 个 WSDL 报 文 示例 ， 这 种 报 文 不 仅 详细 ， 而 且 还 很 
见长 ， 即 使 对 简单 的 服务 来 说 也 是 如 此 。 基 于 SOAP 的 Web 服 务 之 所 以 
没有 基于 REST 的 Web 服 务 那么 流行 ， 其 中 一 部 分 原因 就 与 此 有 关 一 一 
一 个 基于 SOAP 的 Web 服 务 越 复杂 ， 它 对 应 的 WSDL 报 文 就 越 元 长 。 








<?xml version-"1.0" encoding-"UTF-8"?» 

«definitions name -"ChitChat" 
targetNamespace-"http://www.chitchat.com/forum.wsdl" 
xmlns:tnsz"http://www.chitchat.com/forum.wsdl" 
xmlns:soapz"http://schemas.xmlsoap.org/wsdl/soap/" 


xmlns:xsdz"http://www.w3.0rg/2001/XMLSchema" 
xmlnsz"http://schemas.xmlsoap.org/wsdl/"» 
«message name-"GetCommentRequest"» 
«part name-"CommentId" type-"xsd:string"/» 
«/message» 
«message name-"GetCommentResponse"» 
«part name-"Text" type-"xsd:string"/» 
«/message» 
«portType name-"GetCommentPortType"» 
«operation name-"GetComment"» 
«input message-"tns:GetCommentRequest"/» 
«output message-"tns:GetCommentResponse"/» 
«/operation» 
«/portType» 
«binding name-"GetCommentBinding" type-"tns:GetCommentPortType"» 
«soap:binding style-"rpc" 
transportz"http://schemas.xmlsoap.org/soap/http"/» 
«operation name-"GetComment"» 
«soap:operation soapAction-"getComment"/» 


«input» 
«soap:body use-"literal"/» 
«/input» 
«output» 
«soap:body use-"literal"/» 
«/output» 
«/operation» 
«/binding» 
«service name-"GetCommentService" » 
«documentation» 
Returns a comment 
«/documentation» 


«port name-"GetCommentPortType" binding-"tns:GetCommentBinding"» 
«soap:address location-z"http://localhost:8080/GetComment" /» 
«/port» 
«/service» 
«/definitions» 








位 于 报 文 开头 的 是 报 文 对 目 身 的 定义 ， 该 定义 给 出 了 报 文 各 个 部 分 
的 名 字 ， 以 及 这 些 部 分 的 类 型 : 





«message name-"GetCommentRequest"» 

«part name-"CommentId" type-"xsd:string"/» 
«/message» 
«message name-"GetCommentResponse"» 


«part name-"Text" type-"xsd:string"/» 
«/message» 





在 此 之 后 ， 报 文通 过 GetComment 操作 定义 了 
GetCommentPortType 端口 ， 该 操作 的 输入 报 文 
为 GetCommentRequest ， 而 输出 报 文 则 为 GetCommentResponse : 


«portType name="GetCommentPortType "> 
«operation name-"GetComment"» 
«input message-"tns:GetCommentRequest"/» 
«output message-"tns:GetCommentResponse"/» 
«/operation» 
«/portType» 





最 后 ， 报 文 在 位 置 http://localhost:8080/GetComment 定 义 了 一 
个 GetCommentService 服务 ， 并 将 它 与 GetCommentPortType 端口 以 
及 GetCommentsBinding 地 址 进行 绑 定 : 
«service name-"GetCommentService" > 
«documentation» 


Returns a comment 
«/documentation» 


«port name-"GetCommentPortType" binding-"tns:GetCommentBinding"» 
«soap:address location-z"http://localhost:8080/GetComment"/» 
«/port» 
«/service» 





在 实际 中 ，SOAP 请 求 报 文通 常会 由 WSDL 生 成 的 SOAP 客 户 端 负责 
生成 ; 同样 地 ，SOAP 啊 应 报 文 通常 也 是 由 WSDL 生 成 的 SOAP 服 务 器 负 
责 生成 。 具 体 语 言 的 客户 端 ( 如 一 个 Go SOAP 客 户 端 ) 通常 也 会 由 
WSDL 人 负责 生成 ， 而 其 他 代码 则 会 通过 使 用 这 个 客户 端 与 服务 器 进行 交 
互 。 这 样 做 的 结果 是 ， 只 要 WSDL 是 明确 定义 的 ， 那 么 它 生 成 的 SOAP 





客户 端 通常 也 会 是 健壮 的 ， 与 此 同时 ， 这 种 做 法 的 缺陷 是 ， 开 发 人 员 每 
次 修改 服务 器 ， 即 使 是 修改 返回 值 的 类 型 这 样 微小 的 修改 ， 客 户 端 都 需 
要 重新 生成 。 重 复生 成 客户 闻 的 过 程 通 和 常 都 是 见长 而 乏味 的 ， 这 也 解释 
了 为 什么 SOAP Web 服 务 通常 很 少 会 出 现 大 量 的 修改 一 一 因为 对 大 型 的 
SOAP Web 服 务 来 说 ,频繁 的 修改 将 是 一 场 虚 梦 。 











本 章 接 下 来 不 会 再 对 基于 SOAP 的 Web 服 务 做 进一步 的 介绍 ， 但 我 
们 会 学 习 如 何 使 用 Go 语言 创建 以 及 分 析 XML。 


7.3 ”基于 REST 的 Web 服 务 简介 


REST (Representational State Transfer， 具 象 状态 传输 ) 是 一 种 设计 
理念 ， 用 于 设计 那些 通过 标准 的 几 个 动作 来 操纵 资源 ， 并 以 此 来 进行 相 
互 交 流 的 程序 《很 多 REST 使 用 者 都 会 把 操纵 资源 的 动作 称 为 “动词 ”， 
也 就 是 verb) 。 











在 大 多 数 编程 范 型 里 面 ， 程 序 员 都 是 通过 定义 函数 然后 在 主 程序 中 
有 序 地 调用 这 些 函数 来 完成 工作 的 。 在 面 癌 对 象 编程 COOP) 范 型 中 ， 
程序 员 要 做 的 事情 也 是 类 似 的 ， 主 要 的 区 别 在 于 ， 程 序 员 通过 创建 称 大 
对 象 CobjecO 的 模型 来 表示 事物 ， 然 后 定义 称 为 方法 (method) 的 函 
数 并 将 它们 附着 到 模型 之 上 。REST 是 以 上 思想 的 进化 版 ， 但 它 并 不 是 
JE PAAR Cexpose) 为 可 调用 的 服务 ， 而 是 以 资源 (resource) 的 名 
义 把 模型 暴露 出 来 ， 并 允许 人 们 通过 少数 几 个 称 为 动词 的 动作 来 操纵 











在 使 用 HTTP 协 议 实现 REST 服 务 时 ，URL 将 用 于 表示 资源 ， 而 


HTTP 方 法 则 会 用 作 操 纵 资 源 的 动词 ， 具 体 如 表 7-1 所 示 。 





表 7-1 使 用 HTTP 方 法 与 Web 服 务 进行 通信 


HTTP 方 法 使 用 示例 
在 一 项 资源 尚未 存在 的 情况 下 创建 该 资源 


























o 


刚 开 始 学 习 REST 的 程序 员 在 第 一 次 看 到 REST 使 用 的 HTTP 方法 与 











数据 库 的 CRUD 操 作 之 间 的 映射 关系 时 ， 常 常会 对 此 感到 非常 惊奇 。 需 
要 注意 的 是 ， 这 种 映射 并 不 是 一 对 一 映射 ， 而 且 这 种 映射 也 不 是 唯一 
的 。 比 如 说 ， 在 创建 一 项 新 的 资源 时 用 户 既 可 以 使 用 POST ， 也 可 以 使 
用 PUT ， 这 两 种 做 法 都 符合 REST 风 格 。 





POST 和 PUT 的 主要 区 别 在 于 ， 在 使 用 PUT 时 需要 准确 地 知道 哪 一 
项 资源 将 会 被 蔡 换 ， 而 使 用 POST 只 会 创建 出 一 项 新 资源 以 及 一 个 新 
URL。 换 名 话说 ，POST 用 于 创建 一 项 全 新 的 资源 ， 而 PUT NHF E 
一 项 已 经 存在 的 资源 。 





正如 第 1 章 所 言 ，PUT 方法 是 早 等 的 ， 无 论 同 一 个 调用 重复 执行 多 


少 次 ， 服 务 器 的 状态 都 不 会 发 生 任 何 变化 。 无 论 是 使 用 PUT 创建 一 项 资 
源 ， 还 是 使 用 PUT 修改 一 项 已 经 存在 的 资源 ， 给 定 的 URL 上面 都 只 会 有 
一 项 资源 被 创建 出 来 。 相 反 地 ， 因 为 POST 并 不 是 暴 等 的 ， 所 以 每 调 
用 POST 一 次 ， 它 就 会 创建 一 项 新 资源 以 及 一 个 新 URL。 











对 刚 开 始 学 习 REST 的 程序 员 来 说 ， 男 一 个 需要 注意 的 地 方 是 ， 
REST 并 不 是 只 能 通过 表 7-1 提 到 的 4 个 HTTP 方 法 实现 ， 比 如 ， 不 太 常 见 
的 PATCH 方法 就 可 以 用 于 对 一 项 资源 进行 部 分 更 新 。 


下 面 是 一 个 REST 请 求 示例 : 


GET /comment/123 HTTP/1.1 


注意 ， 这 个 GET 请 求 并 没有 与 之 相关 联 的 主体 ， 而 与 这 个 GET 请 求 
相对 应 的 SOAP 请 求 则 正好 相反 : 








POST /GetComment HTTP/1.1 
Host: www.chitchat.com 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap:Envelope 
xmlns:soapz"http://www.w3.0rg/2001/12/soap-envelope" 


soap:encodingStyle-"http://www.w3.0rg/2001/12/soap-encoding"» 
«soap:Body xmlns:m-"http://www.chitchat.com/forum"» 
«m:GetCommentRequest» 
«m: ComnentId»123«/m:CommentId» 
«/m:GetCommentRequest » 
«/soap:Body» 
«/soap:Envelope» 








这 是 因为 在 发 送 第 一 个 请 求 的 时 候 ， 我 们 使 用 了 HITP 的 GET 方法 
作为 动词 来 获取 资源 〈 在 这 个 例子 中 ， 资 源 就 是 一 条 博客 评论 ) 。 对 于 


这 个 GET 请 求 ， 即 使 Web 服 务 返 回 一 个 SOAP 响 应 ， 它 也 会 被 认为 是 一 
个 REST 风 格 的 响应 : 这 是 因为 REST 跟 SOAP 不 同 ， 前 者 关注 的 是 API 的 
设计 ， 而 后 者 关注 的 则 是 被 发 送 报 文 的 格式 。 不 过 ， 因 为 SOAP 报 文 构 
建 起 来 非常 麻烦 ， 所 以 人 们 在 使 用 REST API 的 时 候 通常 都 是 返回 
JSON， 或 者 返回 一 些 比 SOAP 报 文 要 简单 得 多 的 XML， 而 很 少 会 返回 
SOAP 报 文 。 





正如 WSDL 跟 SOAP 的 关系 一 样 ， 基 于 REST 的 Web 服 务 也 拥有 相应 
的 WADL (Web Application Description Language，Web 应 用 摘 述 语 
BO ， 这 种 语言 可 以 对 基于 REST 的 Web 服 务 进行 描述 ， 甚 至 能 够 生成 
访问 这 些 服务 的 客户 端 。 但 是 跟 WSDL 不 同 的 是 ，WADL 没 有 得 到 广泛 
的 使 用 ， 也 没有 进行 标准 化 。 此 外 ，WADL 也 拥有 Swagger、 
RAML (Restful API Modeling Language，REST 风 格 API 建 模 语 言 ) 和 
JSON-home 这 样 的 同类 竞争 产品 。 


在 刚 开始 接触 REST 的 时 候 ， 你 可 能 会 意识 到 这 种 设计 理念 非常 适 
用 于 那些 只 执行 简单 的 CRUD 操 作 的 应 用 ， 但 REST 是 否 适用 于 更 为 复 
杂 的 服务 呢 ? 除 此 之 外 ， 它 又 是 如 何 对 过 程 或 者 动作 进行 建 模 的 呢 ? 








举 个 例子 ， 在 使 用 REST 设 计 的 情况 下 ， 一 个 应 用 要 如 何 才能 激活 
一 个 用 户 的 账号 呢 ? 因为 REST 只 人 允许 用 户 使 用 指定 的 几 个 HITP 方 法 操 
纵 资 源 ， 而 不 允许 用 户 对 资源 执行 任意 的 动作 ， 所 以 应 用 是 无 法 发 送 像 
下 面 这 样 的 请 求 的 : 


ACTIVATE /user/456 HTTP/1.1 


有 一 些 办 法 可 以 绕 过 这 个 问题 ， 下 面 是 最 常用 的 两 种 方法 : 


OD 把 过 程 具体 化 四 ， 或 者 把 动作 转换 成 名 词 ， 然 后 将 其 用 作 资 
源 ; 


(2) 将 动作 用 作 资 源 的 属性 。 
7.3.1 将 动作 转换 为 资源 


对 于 上 面 列举 的 例子 ， 我 们 可 以 把 对 用 户 的 激活 动作 转换 为 对 资源 
的 激活 动作 ， 然 后 通过 向 资源 发 送 HTTP 方 法 来 执行 激活 动作 ， 这 样 一 
来 ， 我 们 就 可 以 通过 以 下 方法 激活 指定 的 用 户 : 


POST /user/456/activation HTTP/1.1 


( "date": "2015-05-15T13:05:05Z" } 





这 段 代码 将 创建 一 个 被 激活 的 资源 〈activation resource? ， 以 此 来 
表示 用 户 的 激活 状态 。 这 种 做 法 的 男 一 个 好 处 是 ， 它 可 以 为 被 激活 的 资 
源 添加 额外 的 属性 。 比 如 ， 在 上 面 展 示 的 例子 中 ， 我 们 惑 将 一 个 日 期 附 
加 给 了 被 激活 的 资源 。 


7.3.3. ”将 动作 转换 为 资源 的 属性 


如 果 用 户 的 激活 与 否 可 以 通过 用 户 账号 的 一 个 状态 来 确定 ， 那 么 我 
们 只 需要 将 激活 动作 用 作 资 源 的 属性 ， 然 后 通过 HTTP 的 PATCH 方法 对 
该 资源 进行 部 分 更 新 即 可 ， 就 像 这 样 : 

PATCH /user/456 HTTP/1.1 


{ "active" : "true" } 


这 段 代 码 将 把 用 户 资 源 的 active 属性 设置 为 true 。 
7.4 通过 Go 分 析 和 创建 XML 


在 对 SOAP 风 格 的 web 服务 和 REST 风 格 的 Web 服 务 有 了 基本 的 了 解 
之 后 ， 接 下 来 就 让 我 们 看 看 Go 语言 是 如 何 实现 这 两 种 服务 的 。 首 先 ， 
本 节 会 介绍 如 何 创建 和 处 理 SOAP Web 服 务 会 用 到 的 XML 数据 ， 而 下 一 
节 则 会 介绍 如 何 创建 和 处 理 REST Web 服 务 会 用 到 的 JSON 数 据 。 





XML 可 以 以 结构 化 的 形式 表示 数据 ， 它 跟 本 书 前 面 提 到 的 HTML 一 
样 ， 都 是 一 种 流行 的 标记 语言 。XML 可 能 是 在 表示 、 发 送 和 接收 结构 
化 数据 方面 使 用 最 广泛 的 一 种 格式 ， 这 种 格式 获得 了 W3C 组 织 的 正式 推 
存 ，W3C 友 布 的 XML 1.0 规 范 中 给 出 了 这 一 格式 的 具体 定义 。 


因为 我 们 经 常会 用 到 其 他 人 提供 的 Web 服务 ， 或 者 需要 处 理 诸如 
RSS 这 样 基于 XML 的 数据 源 ， 所 以 无 论 你 最 终 是 否 会 编写 或 使 用 Web 服 
务 ， 学 习 如 何 创建 和 分 析 XML 都 是 一 项 非常 重要 的 技能 。 即 使 你 不 需 
要 开发 自己 的 XML Web 服 务 ， 学 会 如 何 使 用 Go 与 XML 进行 交互 也 是 非 
常 有 用 的 一 件 事 。 比 如 说 ， 你 可 能 会 需要 从 一 个 RSS 新 闻 源 里 面 获取 数 
据 ， 并 将 其 用 作 自 己 的 数据 源 之 一 。 在 这 种 情况 下 ， 你 必须 懂得 如 何 分 
析 XML 并 从 中 提取 出 自己 想 要 获取 的 信息 。 





无 论 是 使 用 XML、JSON 还 是 其 他 格式 ， 使 用 Go 语言 分 析 结 构 化 数 
据 的 方法 都 是 相似 的 。 对 XML 和 JSON 进 行 操作 需要 分 别 用 到 encoding 
库 中 的 XML 子 包 和 JSON 子 包 ， 现 在 ， 就 让 我 们 来 看 看 encoding/xml 
子 包 的 使 用 方法 。 


7.4.1 分 析 XML 


因为 分 析 XML 是 刚 开 始 接触 XML 时 经 常会 做 的 一 件 事 ， 所 以 我 们 
就 以 学 习 如 何 分 析 XML 为 开始 。 在 Go 语言 里 面 ， 用 户 首先 需要 将 XML 
的 分 析 结 果 存 储 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 结构 来 获取 XML 
记录 的 数据 。 下 面 是 分 析 XML 时 第 见 的 两 个 步 又: 


(1) 创建 一 些 用 于 存储 XML 数据 的 结构 ; 


(2) 使 用 xml.Unmarshal 将 XML 数据 解 封 (unmarshal) 到 结构 
里 面 ， 如 图 7-2 所 示 。 





图 7-2 ”使 用 Go 对 XML 进行 分 析 : 将 XML 解 封 至 结构 
代码 清单 7-1 展 示 了 一 个 简单 的 XML 文件 post .xml 。 
代码 清单 7-1 ”一 个 简单 的 XML 文件 post .xml 


<?xml version-"1.0" encoding-"utf-8"?» 
«post id="1"> 
«content»Hello World!«/content» 


«author idz"2"»Sau Sheong«/author» 
«/post» 





代码 清单 7-2 展 示 了 分 析 这 个 XML 所 需 的 代码 ， 这 些 代 码 存 储 在 文 
件 xml.go E. 




















代码 清单 7-2 ”对 XML 进行 分 析 





package main 


import ( 
"encoding/xml" 
"fmt" 
"io/ioutil" 


OS 


) 


type Post struct ( / [tA e 
XMLName xml.Name ^xml:"post 
Id string X" xml:"id,attr'"" 
Content string xml:"content'' 
Author Author  ^xml:"author 
Xml string  "xml:",innerxml"' 


} 


type Author struct { 
Id string '"xml:"id,attr'"^ 
Name string `xml:",chardata"` 


j 


func main() { 

xmlFile, err := os.Open("post.xml") 

if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 

} 

defer xmlFile.Close() 

xmlData, err :- ioutil.ReadAll(xmlFile) 

if err != nil { 
fmt.Println("Error reading XML data:", err) 
return 


} 


var post Post 
xml.Unmarshal(xmlData, &post) e 
fmt.Println(post) 


} 





Q 定义 一 些 结构 ， 用 于 表示 数据 


O 将 XML 数据 解 封 到 结构 里 面 


分 析 程 序 定义 了 用 于 表示 数据 的 Post 结构 和 Author 结构 。 因 为 程 
序 想 要 在 获取 作者 信息 的 同时 也 获取 作者 信息 所 在 元 素 的 id 属性 ， 所 
以 程序 使 用 了 单独 的 Author 结构 来 表示 帖子 的 作者 ， 但 并 没有 使 用 单 
独 的 Content 结构 来 表示 帖子 的 内 容 。 如 果 我 们 不 打算 获取 作者 信息 的 
id 属性 ， 也 可 以 定义 一 个 下 面 这 样 的 Post 结构 ， 并 直接 使 用 字符 串 来 
表示 帖子 的 作者 信息 (代码 中 的 加 粗 行 〉: 














type Post struct { 
XMLName xml.Name ^xml:"post"^ 
Id string ^ xml:"id,attr'" 
Content string . xml:"content'' 
Author string "xml:"author"^ 


Xml string "xml: ",innerxml"^ 





Post 结构 中 每 个 字段 的 定义 后 面 都 带 有 一 段 使 用 反 引 号 CO 包围 
的 信息 ， 这 些 信息 被 称 为 结构 标签 〈struct tag) ，Go 语 言 使 用 这 些 标签 
来 决定 如 何 对 结构 以 及 XML 元 系 进 行 映射 ， 如 图 7-3 所 示 。 











结构 标签 


type Post struct { 
XMLName xml.Name 'xml:"post"' 


Id string xml:"id,attr"' 
Content string "amil tcontent" 
Author Author “xml: "author" ` 


xml string xml:",innerxml"' 
键 值 
图 7-3 ”结构 标签 用 于 定义 XML 和 结构 之 间 的 映射 
结构 标签 是 一 些 跟 在 字段 后 面 ， 使 用 字符 串 表 示 的 键 值 对 : 它 的 键 
是 一 个 不 能 包含 空格 、 引 号 CO) 或 者 冒号 C) 的 字符 串 ， 而 值 则 是 


一 个 被 双 引 号 C" 包围 的 字符 串 。 在 处 理 XML 时 ， 结 构 标 和 俭 的 键 总 


是 为 xml 。 








为 什么 使 用 反 引 号 来 包围 结构 标签 








因为 Go 语言 使 用 双 引 号 C") ARIS CO 来 包围 字符 串 ， 使 用 单 引 号 (' ) 来 包围 
rune (一 种 用 于 表示 Unicode 人 码 点 的 ijnt32 类 型 ) ， 并 且 因 为 结构 标签 内 部 已 经 使 用 了 双 引 号 
来 包围 键 的 值 ， 所 以 为 了 避免 进行 转 义 ，Go 语 言 就 使 用 了 反 引 号 来 包围 结构 标签 。 




















出 于 创建 映射 的 需要 ，xml 包 要 求 被 映射 的 结构 以 及 结构 包含 的 所 
有 字段 都 必须 是 公开 的 ， 也 惑 是 ， 它 们 的 名 字 必 须 以 大 写 的 英文 字母 开 
头 。 以 上 面 展示 的 代码 为 例 ， 结 构 的 名 字 必 须 为 Post 而 不 能 是 post ， 


至 于 字段 的 名 字 则 必须 为 Content 而 不 能 是 content 。 
下 面 是 XML 结构 标签 的 其 中 一 些 使 用 规则 。 


(1) 通过 创建 一 个 名 字 为 XMLName 、 类 型 为 xm1.Name 的 字段 ， 
可 以 将 XML 元 素 的 名 字 存 储 在 这 个 字段 里 面 〈 在 一 般 情况 下 ， 结 构 的 
名 字 就 是 元 素 的 名 字 ) o 














(2) 通过 创建 一 个 与 XML 元 素 属 性 同名 的 字段 ， 并 使 用 'xm1:" 
«name >,attr" ' 作 为 该 字段 的 结构 标签 ， 可 以 将 元 素 的 cname > 属性 
的 值 存储 到 这 个 字段 里 面 。 





(3) 通过 创建 一 个 与 XML 元 素 标签 同名 的 字段 ， 并 使 
用 'xml:",chardata"' 作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 素 的 字 
符 数 据 存储 到 这 个 字段 里 面 。 





(4) 通过 定义 一 个 任意 名 字 的 字段 ， 并 使 用 'xml:",innerxml"' 
作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 素 中 的 原始 XML 存储 到 这 个 字 
段 里 面 。 


(5) 没有 模式 标志 (如 ,attr 、,chardata 或 者 ,innerxml ) 的 
结构 字段 将 与 同名 的 XML 元 素 匹 配 。 





(60 使 用 'xml:"a>b>c"" 这 样 的 结构 标签 可 以 在 不 指定 树 状 结构 
的 情况 下 直接 获取 指定 的 XML 元 素 ， 其 中 a 和 b 为 中 间 元 紊 ， 而 c 则 是 
想 要 获取 的 节点 元 素 。 




















要 一 下 子 了 解 这 么 多 规则 并 不 容易 ， 特 别 是 对 最 后 儿 条 规则 来 说 更 





是 如 此 ， 所 以 我 们 最 好 还 是 来 看 一 些 实际 应 用 这 些 规则 的 例子 。 


代码 清单 7-3 给 出 了 表示 帖子 XML 元 素 的 post 变量 及 其 对 应 的 Post 
结构 。 























代码 清单 7-3 ”用 于 表示 帖子 的 简单 的 XML 元 素 

















<post id="1"> 
«content»Hello World!«/content» 


«author id-"2"»Sau Sheong«/author» 
«/post» 





而 下 面 是 post 元 素 对 应 的 Post 结构 : 


type Post struct ( 
XMLName xml.Name ^xml:"post"^ 
Id string `xml:"id,attr" 
Content string `xml:"content"` 


Author Author  ^xml:"author"' 
Xml string  "xml:",innerxml"' 


} 





分 析 程 序 定义 了 与 XML 元 素 post 同名 的 Post 结构 ， 虽 然 这 种 做 法 
非常 常见 ， 但 是 在 某 些 时 候 ， 结 构 的 名 字 与 XML 元 素 的 名 字 可 能 并 不 
相同 ， 这 时 用 户 就 需要 一 种 方法 来 获取 元 素 的 名 字 。 为 此 ，xml 包 提 供 
了 一 种 机 制 ， 使 用 户 可 以 通过 定义 一 个 名 为 XMLName . 2878 
为 xm1.Name 的 字段 ， 并 将 该 字段 映射 至 元 素 自 映 来 获取 XML 元 素 的 名 
字 。 在 Post 结构 的 例子 中 ， 这 一 映射 承 是 通过 ' xm1:"post"' 结构 标 
签 来 完成 的 。 根 据 规则 1 一 一 “使 用 XMLName 字段 存储 元 素 的 名 字 ”， 分 
析 程 序 将 元 素 的 名 字 post 存储 到 了 Post 结构 的 XMLName 字段 里 面 。 























XML 元 素 post 拥有 一 个 名 为 id 的 属性 ， 根 据 规则 2 一 一 “使 用 结构 
标签 xml:"&lt;name&gt;, ^ attr" </code> 存 储 属 性 的 值 ”， 
分 析 程 序 通 过 结构 标签 ccode> xml:"id,attr'"^ 将 id 属性 的 值 存 储 到 
了 Post 结构 的 Id FREH. 





post 元 素 包 含 了 一 个 content 子 元 素 ， 这 个 子 元 素 没 有 属性 ， 但 
它 包含 了 字符 数据 Hello World! ， 根 据 规则 5 一 一 “没有 模式 标志 的 结 
构 字段 将 与 同名 的 XML 元 素 进 行 上 匹配?”， 分 析 程 序 通过 结构 标 
签 'xml:"content"' 将 content 子 元 际 包含 的 字符 数据 存储 到 了 Post 
结构 的 Content 字段 里 面 。 





根据 规则 4 一 一 “使 用 结构 标签 'xml:",innerxml"' 可 以 获取 原始 
XML”， 分 析 程 序 定义 了 一 个 Xml1 字段 ， 并 使 用 'xml:",innerxml"' 作 
为 该 字段 的 结构 标签 ， 以 此 来 获得 被 post 元 素 包 含 的 原始 XML: 


«content»Hello World!«/content» 
«author id-"2"»Sau Sheong«/author» 


子 元 素 author 拥有 id 属性 ， 并 且 包 含 字 符 数 据 Ssau Sheong 7j 
了 正确 地 构建 映射 ， 分 析 程 序 专门 定义 了 Author 结构 : 








type Author struct { 
Id string `xml:"id,attr"` 


Name string 'xml:",chardata'"" 


} 





根据 规则 5，author 子 元 素 被 映射 到 了 带 有 "xm1:"author"' 结构 
标签 的 Author 字段 。 在 Author 结构 中 ， 属 性 id 的 值 被 映射 到 了 带 


有 'xml:"id,attr"' 结构 标签 的 Id 字段 ， 而 字符 数据 sau Sheong I 
被 映射 到 了 带 有 'xml:",chardata"' 结构 标签 的 Name 字段 。 


俗话 说 ， 百 闻 不 如 一 见 。 在 详细 了 解 了 整个 分 析 程 序 之 后 ， 接 下 来 
就 让 我 们 实际 运行 一 下 这 个 程序 。 在 终端 里 面 执 行 以 下 命令 : 


如 果 一 切 正 常 ， 这 一 命令 应 该 会 返回 以 下 结 


{{ post} 1 Hello World! {2 Sau Sheong} 
«content»Hello World!«/content» 
«author id-z"2"»Sau Sheong«/author» 


} 





让 我 们 逐一 地 分 析 这 些 结果 。 首 先 ， 因 为 post 变量 是 Author 结构 
的 一 个 实例 ， 所 以 整个 结果 都 被 包围 在 了 一 对 大 括号 〈{} ) 里 
Ii. post 结构 的 第 一 个 字段 是 另 一 个 类 型 为 xn1.Name 的 结构 ， 这 个 结 
构 在 结果 中 表示 为 { post } 。 在 此 之 后 展示 的 数字 1 为 Id 字段 的 值 ， 
而 "Hello World!" 则 是 Content 字段 的 值 。 再 之 后 展示 的 是 存储 
在 Author 结构 里 面 的 内 容 ，{2 Sau Sheong) 。 结 果 最 后 展示 的 是 
XML 元 素 post 内 部 包含 的 原始 XML 。 




















前 面 的 内 容 列 举 了 规则 1 至 规则 5 的 使 用 示例 ， 现 在 让 我 们 来 看 看 规 
则 6 是 如 何 运 作 的 。 规 则 6 声称 ， 使 用 结构 标签 'xml:"a>b>c"'， 可 以 
在 不 指定 树 状 结构 的 情况 下 ， 越 过 中 间 元 素 a Mb 直接 访问 节点 元 素 c 





代码 清单 7-4 展 示 的 是 另 一 个 XML 示例 ， 这 个 XML 也 存储 在 名 
为 post .xml 的 文件 中 。 





代码 清单 7-4 TH BCEIUSRHJXMLOCTE 


< ?xml version="1.0" encoding="utf-8"?> 
< post id="1"> 
< content»Hello World!« /content> 
< author id-"2"»Sau Sheong« /author> 
< comments» 


comment id-"1"» 

< content»Have a great day!« /content» 
< author id-z"3"»Adam« /author» 

/ comment» 


comment id="2"> 


< content»How are you today?« /content» 


< author idz"A"»Betty« /author» 


< /comment» 


« /comments» 


< /post> 





这 个 XML 文 件 的 前 半 部 分 内 容 跟 之 前 展示 的 XML 文 件 是 相同 的 ， 


而 加 粗 显 示 的 则 是 新 出 现 的 代码 ， 这 些 新 代码 定义 了 一 个 名 

为 comments 的 XML 子 元 素 ， 并 且 这 个 元 素 本 身 也 包含 多 个 comment T 
元 素 。 这 一 次 ， 分 析 程 序 需要 获取 帖子 的 评论 列表 ， 但 为 此 专门 创建 一 
个 Comments 结构 可 能 会 显得 有 些小 题 大 做 了 。 为 了 简化 实现 代码 ， 分 
析 程 序 将 根据 规则 6 对 comments 这 个 XML 子 元 素 进行 跳跃 式 访问 。 代 
码 清单 7-5 展 示 了 经 过 修改 的 Post 结构 ， 修 改 后 的 Post 结构 带 有 新 增 
的 字段 以 及 实现 跳跃 式 访问 所 需 的 结构 标签 。 





代码 清单 7-5 WA comments 结构 字段 的 Post 结构 


type Post struct { 
XMLName xml.Name  "xml:"post"' 
Id string ^"xml:"id,attr"^ 
Content string "xml:"content"^ 
Author Author `xml: "author" 


Xml string `xml:",innerxml"` 
Comments []Comment 'xml:"comments»comment"^ 





正如 代码 中 的 加 粗 行 所 示 ， 分 析 程 序 为 了 获取 帖子 的 评论 列表 ， 
在 Post 结构 中 增加 了 类 型 为 Comment 结构 切片 的 Comments 字段 ， 并 通 
过 结构 标签 'xm1:"comments>comment"”' 将 这 个 字段 映射 至 名 
为 comment 的 XML 子 元 素 。 根 据 规则 6， 这 一 结构 标签 将 允许 分 析 程 序 
跳 过 XML 中 的 comments 元 素 ， 直 接 访 问 comment 子 元 素 。 








Comment 结构 和 Post 结构 非常 相似 ， 它 的 具体 定义 如 下 : 





type Comment struct { 
Id string `xml:"id,attr"` 
Content string `xml:"content"` 


Author Author 'xml:"author"' 
} 


在 定义 了 进行 语法 分 析 所 需 的 结构 以 及 映射 关系 之 后 ， 现 在 是 时 候 
将 XML 数据 解 封 到 这 些 结构 里 面 了 。 因 为 负责 执行 解 封 操作 的 
Unmarshal 消 数 只 接受 字 节 切片 (也 就 是 字符 串 〉 作 为 参数 ， 所 以 分 析 
程序 首先 要 做 的 就 是 将 XML 文 件 转 换 为 字符 串 ， 这 一 操作 可 以 通过 以 
下 代码 来 实现 在 执行 这 些 代码 时 ，XML 文 件 必须 与 Go 文件 处 于 同一 
Hob): 
xmlFile, err :- os.Open("post.xml") 
if err !- nil ( 

fmt.Println("Error opening XML file:", err) 


return 


defer xmlFile.Close() 


xmlData, err :- ioutil.ReadAll(xmlFile) 

if err !- nil ( 
fmt.Println("Error reading XML data:", err) 
return 


} 





在 将 XML 文 件 的 内 容 读 取 到 xmlData 变量 里 面 之 后 ， 分 析 程 序 可 
以 通过 执行 以 下 代码 来 解 封 XML 数据 : 


var post Post 
xml.Unmarshal(xmlData, &post) 


如 果 你 曾经 使 用 其 他 编程 语言 分 析 过 XML， 那 么 你 应 该 会 知道 ， 
这 种 做 法 虽然 能 够 很 好 地 处 理 体 积 较 小 的 XML 文件 ， 但 是 却 无 法 高 效 
地 处 理 以 流 (stream) 方式 传输 的 XML 文件 以 及 体积 较 大 的 XML 文件 。 
为 了 解决 这 个 问题 ， 我 们 需要 使 用 Decoder 结构 来 代替 Unmarshal K 





数 ， 通 过 手动 解码 XML 元 系 的 方式 来 解 封 XML 数 据 ， 这 个 过 程 如 图 7-4 
所 示 。 





图 7-4 ”使 用 Go 分 析 XML: 将 XML 解码 至 结构 


代码 清单 7-6 展 示 了 如 何 使 用 Decoder 分 析 前 面 提 到 的 XML 文件 。 


代码 清单 7-6 ”使 用 Decoder 分 析 XML 





package main 


import ( 
"encoding/xml" 
n" fmt "n" 


10 
os 


) 
type Post struct { 
XMLName xml.Name `xml:"post"` 


Id string `xml:"id,attr"` 

Content string `xml: "content" 

Author Author `xml:"author"` 

Xml string `xml:",innerxml"` 
Comments []Comment `xml:"comments>comment"` 


} 


type Author struct { 
Id string `xml:"id,attr" 
Name string `xml:",chardata"` 


) 


type Comment struct { 
Id string '"xml:"id,attr'"^ 
Content string 'xml:"content"" 
Author Author 'xml:"author"^ 


) 


func main() { 


xmlFile, err := os.Open("post.xml") 
if err !- nil ( 
fmt.Println("Error opening XML file:", err) 
return 
I 
defer xmlFile.Close() 
decoder := xml.NewDecoder(xmlFile) e 
for ( e 
t, err := decoder.Token() e 
if err == io.EOF ( 
break 
} 
if err != nil { 
fmt.Println("Error decoding XML into tokens:", err) 
return 
} 


switch se := t.(type) ( e 
case xml.StartElement: 
if se.Name.Local == "comment" { 
var comment Comment 
decoder.DecodeElement(&comment, &se) © 





O 根据 给 定 的 XML 数据 生成 相应 的 解码 器 


O 每 迭代 一 次 解码 器 中 的 所 有 XML 数据 

O 每 进行 一 次 迭代 ， 就 从 解码 器 里 面 获取 一 个 token 
€ 检查 token 的 类 型 

O 将 XML 数据 解码 至 结构 


虽然 这 段 代 码 只 演示 了 如 何 解 码 comment 元 素 ， 但 这 种 解码 方式 同 


样 可 以 应 用 于 XML 文件 中 的 其 他 元 素 。 这 个 新 的 分 析 程 序 会 通过 
Decoder 结构 ， 一 个 元 素 接 一 个 元 素 地 对 XML 进行 解码 ， 而 不 是 像 之 
前 那样 ， 使 用 Unmarshal 函数 一 次 将 整个 XML 解 封 为 字符 串 。 





对 XML 进行 解码 首先 需要 创建 一 个 Decoder ， 这 一 点 可 以 通过 调 
用 NewDecoder 并 向 其 传递 一 个 io.Reader 来 完成 。 在 上 面 展 示 的 代码 
清单 中 ， 程 序 就 把 os.0pen 打开 的 xmlFile 文件 传递 给 了 NewDecoder 


在 拥有 了 解码 器 之 后 ， 程 序 就 会 使 用 Token 方法 来 获取 XML 流 中 
的 下 一 个 token: 在 这 种 情景 下 ，token 实 际 上 就 是 一 个 表示 XML 元 素 的 
接口 。 为 了 从 解码 器 里 面 取 出 所 有 token， 程 序 使 用 一 个 无 限 for 循环 包 
里 起 了 从 解码 器 里 面 获取 token 的 相关 动作 。 当 解码 器 包含 的 所 有 token 
都 已 被 取出 时 ，Token 方法 将 返回 一 个 表示 文件 数据 或 数据 流 已 被 读 取 
完毕 的 io.EOF 结构 作为 结果 ， 并 将 返回 值 中 的 err 变量 的 值 设置 为 nil 





分 析 程 序 从 解码 器 里 取出 token 之 后 会 对 该 token 进 行 检查 以 确认 其 
是 否 为 StartElement ， 也 就 是 ， 判 断 该 token 是 否 为 XML 元 素 的 起 始 
标签 。 如 果 是 的 话 ， 那 么 程序 会 继续 对 这 个 token 进 行 检 查 ， 看 它 是 否 
就 是 XML 中 的 comment 元 系 。 在 确认 了 自己 遇 到 的 是 comment 元 素 之 
后 ， 程 序 就 会 将 整个 token 解 码 至 Comment 结构 ， 从 而 得 到 与 解 封 XML 
元 素 相同 的 结果 。 


因为 手动 解码 XML 文件 需要 做 更 多 工作 ， 所 以 这 种 方法 并 不 适用 
于 处 理 小 型 的 XML 文件 。 但 如 果 程 序 面 对 的 是 流 式 XML 数据 ， 或 者 体 





积 非常 庞大 的 XML 文件 ， 那 么 解码 将 是 从 XML 里 提取 数据 唯一 可 行 的 
办 法 。 


在 结束 本 小 节 并 转 同 讨论 如 何 创 建 XML 之 前 ， 还 有 一 点 需要 说 明 
一 下 ， 那 就 是 : 本 节 介 绍 的 分 析 规 则 只 是 XML 分 析 规 则 的 一 部 分 ， 如 
果 你 想 要 更 详细 地 了 解 这 些 规则 ， 可 以 去 查看 xm]l 库 的 文档 ， 或 者 直接 
阅读 xml 库 的 源码 。 


7.4.2 ”创建 XML 


在 上 一 节 中 ， 我 们 花 了 不 少时 间 学 习 如 何 分 析 XML， 笠 运 的 是 ， 
因为 创建 XML 正好 就 是 分 析 XML 的 逆 操 作 ， 所 以 上 一 节 介 绍 的 知识 在 
本 节 也 是 适用 的 。 在 上 一 节 中 ， 我 们 学 习 的 是 怎样 把 XML 解 封 到 结构 
里 面 ， 而 这 一 节 我 们 要 学 习 的 则 是 怎样 把 Go 结构 封装 (marshal) 至 
XML; 同样 ， 上 一 节 我 们 学 习 的 是 怎样 把 XML 解码 至 Go 结构 ， 而 本 贡 
我 们 要 学 习 的 则 是 怎样 把 Go 结构 编码 至 XML， 这 个 过 程 如 图 7-5 所 示 。 





图 7-5 “使 用 Go 创建 XML: 创建 结构 并 将 其 封装 至 XML 


首先 让 我 们 来 看 看 封装 操作 是 如 何 进行 的 。 代 码 清单 7-7 展 示 了 文 
件 xm1.go 包含 的 代码 ， 这 些 代码 会 创建 一 个 名 为 post .xml 的 XML 文 
fF. 


代码 清单 7-7 使 用 Marshal 函数 生成 XML 文件 


package main 


import ( 
"encoding/xml" 
"fmt" 
"io/ioutil" 


) 


type Post struct { 
XMLName xml.Name '^xml:"post 
Id string X" xml:"id,attr'" 
Content string ` xml:"content"` 
Author Author  ^xml:"author"' 


} 


type Author struct { 
Id string "xml:"id,attr'"^ 
Name string 'xml:",chardata 


} 


func main() { 
:= Post{ 
"1", 

Content: " Hello World!", e 
Author: Author( 

Id: "2"， 

Name: "Sau Sheong", 
); 

} 


output, err := xml.Marshal(&post) 

if err != nil { e 
fmt.Println("Error marshalling to XML:", err) 
return 


} 
err = ioutil.WriteFile("post.xml", output, 0644) 


if err !- nil { 
fmt.Println("Error writing XML to file:", err) 
return 


} 





@ 创 建 结构 并 向 里 面 填充 数据 





O 把 结构 封 厂 为 由 字 节 切片 组 成 的 XML 数据 


正如 代码 所 示 ， 封 装 XML 和 解 封 XML 时 使 用 的 结构 以 及 结构 标签 
是 完全 相同 的 : 封装 操作 只 不 过 是 把 处 理 过 程 反 转 了 过 来 ， 然 后 根据 结 
构 创 建 相 应 的 XML 罢了 。 封 装 程 序 首先 需要 创建 表示 帖子 的 post i 
构 ， 并 向 结构 里 面 填 充 数据 ， 然 后 只 要 调用 Marshal 函数 ， 就 可 以 根 
据 Post 结构 创建 相应 的 XML 了 。 作 为 例子 ， 下 面 束 是 Marshal 函数 根 
据 Post 结构 创建 出 的 XML 数据 ， 这 些 数据 包含 在 了 post .xml 文件 里 
面 : 








«post id-"1"»«content»Hello World!«/content»«author id="2">Sau Sheong«/aut 


hor»«/post» 





虽然 样子 并 不 是 特别 好 看 ， 但 函数 生成 出 来 的 的 的 确 确 束 是 一 段 
XML。 如 果 想 要 让 程序 生成 更 好 看 的 XML， 那 么 可 以 使 
用 MarshalIndent KR Marshal KA: 





output, err := xml.MarshalIndent(&post, "", "\t") 





MarshalIndent 函数 跟 Marshal 函数 一 样 ， 都 接受 一 个 指向 结构 
的 指针 作为 自己 的 第 一 个 参数 ， 但 除 此 之 外 ，MarshalIndent 函数 还 
接受 两 个 额外 的 参数 ， 这 两 个 参数 分 别 用 于 指定 添加 到 每 个 输出 行 前 面 
的 前 级 以 及 缩 进 ， 其 中 缠 进 的 数量 会 随 着 元 素 的 舱 套 层次 增加 而 增加 。 
在 处 理 相 同 的 Post 结构 时 ，MarshalIndent 函数 将 产生 以 下 更 为 美观 
的 输出 : 


<post id="1"> 
«content»Hello World!«/content» 





«author id="2">Sau Sheong«/author» 
«/post» 


因为 这 段 XML 缺 少 了 XML 声明 ， 所 以 从 格式 上 来 说 这 段 XML 并 不 
完全 正确 。 虽 然 xml 库 不 会 自动 为 Marshal Ca 生成 
的 XML 添加 XML 声明 ， 但 用 户 可 以 很 轻易 地 通过 xm1.Header 常量 将 
XML 声明 添加 到 封装 输出 之 前 : 





err = ioutil.WriteFile("post.xml", []byte(xml.Header + string(output)), 06 


44) 





过 把 xm1.Header 添加 到 输出 结果 之 前 ， 并 将 这 些 内 容 全 部 写 
Ee 文件 ， 我 们 就 得 到 了 一 段 带 有 XML 声 明 的 XML: 
<?xml version-"1.0" encoding="UTF-8"?> 


«post id-"1"» 
«content»Hello World!«/content» 


«author id-"2"»Sau Sheong«/author» 
«/post» 





正如 我 们 可 以 手动 将 XML 解码 到 Go 结构 里 面 一 样 ， 我 们 同样 可 以 
手动 将 Go 结构 编码 到 XML 里面， 图 7-6 展 示 了 这 个 过 程 ， 代 码 清单 7-8 则 
展示 了 一 个 简单 的 编码 示例 。 


创建 结构 并 创建 用 于 存储 XML 创建 用 于 编码 通过 编码 器 把 结 
向 其 填充 数据 数据 的 XML 文 件 结构 的 编码 器 构 编 码 至 XML 文 件 


图 7-6 ”使 用 Go 创建 XML: 通过 使 用 编码 器 来 将 结构 编码 至 XML 














代码 清单 7-8 手动 将 Go 结构 编码 至 XML 





package main 


import ( 
"encoding/xml" 
"fmt" 


OS 


) 


type Post struct { 
XMLName xml.Name 'xml:"post 
Id string ~ xml:"id,attr". 
Content string `xml:"content™"` 
Author Author  ^xml:"author"' 


} 


type Author struct { 
Id string "xml:"id,attr'" 
Name string '"xml:",chardata 


} 


func main() { 
:= Post{ 
"1" @ 

Content: "Hello World!", 
Author: Author( 

Id: "2", 

Name: "Sau Sheong", 
); 
} 


xmlFile, err := os.Create("post.xml") @ 

if err !- nil { 
fmt.Println("Error creating XML file:", err) 
return 


} 


encoder := xml.NewEncoder(xmlFile) e 

encoder.Indent("", "WXt") 

err - encoder.Encode(&post) e 

if err != nil { 
fmt.Println("Error encoding XML to file:", err) 
return 

} 

} 





O 创建 结构 并 向 里 面 填充 数据 


e 创建 用 于 存储 数据 的 XML 文件 
O 根据 给 定 的 XML 文件 ， 创 建 出 相应 的 编码 器 
O 把 结构 编码 至 文件 


跟 之 前 一 样 ， 程 序 首先 创建 了 将 要 被 编码 的 Post 结构 ， 接 着 通过 
os.Create 创建 出 了 将 要 写 入 的 XML 文件 ， 然 后 使 用 NewEncoder 函数 
创建 了 一 个 包 右 着 XML 文件 的 编码 器 。 在 设置 好 相应 的 前 绥 和 缩 进 之 
后 ， 程 序 就 会 使 用 编码 器 的 Encode 方法 对 传 入 的 Post 结构 进行 编码 ， 
最 终 创 建 出 包含 以 下 内 容 的 post . xml 文件 : 


«post id-"1"» 
«content»Hello World!«/content» 


«author id-"2"»Sau Sheong«/author» 
«/post» 





通过 这 一 节 的 学 习 ， 读 者 应 该 已 经 了 解 了 如 何 分 析 和 创建 XML 。 
要 注意 的 是 ， 本 市 讨论 的 只 是 分 析 和 创建 XML 的 基础 知识 ， 如 果 想 
要 知道 关于 这 方面 的 更 多 信息 ， 可 但 看 相应 的 文档 以 及 源码 ( 别 担心 ， 
阅读 源码 并 没有 想象 中 那么 可 怕 )〉。 


7.5 ”通过 Go 分 析 和 创建 JSON 


JSON (JavaScript Object Notation) 是 衍生 上 自 JavaScript 语 言 的 一 种 
轻 量 级 的 文本 数据 格式 ， 这 种 格式 的 主要 设计 理念 是 既 能 够 轻易 地 被 人 
类 读 懂 ， 叉 能 够 简单 地 被 机 器 读 取 。JSON 最 初 由 Douglas Crockford 定 
义 ， 现 在 则 由 RFC 7159 和 ECMA-404 描 述 。 昌 然 接受 和 返回 JSON 数 据 





并 不 是 实现 REST Web 服 务 的 唯一 选择 ， 但 大 多 数 REST Web 服 务 都 是 这 
样 做 的 。 


在 与 REST Web 服 务 打交道 的 时 候 ， 我 们 常常 会 以 某 种 形式 与 JSON 
不 期 而 遇 ， 要 么 就 是 为 了 创建 JSON， 要 么 就 是 为 了 处 理 JSON， 又 或 者 
两 者 此 有 。 处 理 JSON 在 web 应 用 中 非常 常见 : 无 论 是 从 Web 服 务 里 面 获 
取 数 据 ， 还 是 通过 第 三 方 身 份 验证 服务 登录 Web 应 用 ， 又 或 者 对 其 他 服 
务 进行 控制 ， 通 常 都 需要 处 理 JSON 数 据 。 





跟 处 理 JSON 一 样 ， 创 建 JSON 也 非常 常见 : Go 语言 经 常会 被 用 于 创 
建 为 前 哨 应 用 提供 服务 的 Web 服 务 后 端 ， 其 中 就 包括 基于 JavaScript 的 前 
端 应 用 ， 而 这 些 应 用 篆 稍 会 运行 着 React.js 和 Angular.js 这 样 的 JavaScript 
库 。 除 此 之 外 ，Go 语 言 还 会 被 用 于 为 物 联 网 以 及 诸如 智能 手表 这 样 的 
可 罕 戴 设备 创建 Web 服 务 。 因 为 在 很 多 情况 下 ， 这 些 前 端 应 用 都 是 基于 
JSON 开 发 的 ， 所 以 它们 与 后 端 进 行 交互 最 自然 的 方式 当然 也 是 使 用 
JSON 。 





正如 Go 语言 提供 对 XML 的 支持 一 样 ，Go 语 言 也 通过 
encoding/json 库 提 供 对 JSON 的 文 持 。 和 上 一 节 一 样 ， 我 们 首先 会 学 
习 如 何 分 析 JSON， 然 后 再 学 习 如 何 创建 JSON 数 据 。 


7.5.1 分 析 JSON 





分 析 JSON 的 步骤 和 分 析 XMEL 的 步骤 基本 相同 分 析 程 序 首 先 要 
做 的 就 是 把 JSON 的 分 析 结 果 存 储 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 
结构 来 提取 数据 。 下 面 是 分 析 JSON 的 两 个 常见 步骤 〈 这 个 过 程 如 图 7-7 
所 示 ) : 





图 7-7 使 用 Go 分 析 JSON: 创建 结构 并 将 JSON 解 封 到 结构 里 面 





(1) 创建 一 些 用 于 包含 JSON 数 据 的 结构 ; 
(2) 通过 json.Unmarshal 函数 ， 把 JSON 数 据 解 封 到 结构 里 面 。 


跟 上 映射 XML 相 比 ， 把 结构 映射 至 JSON 要 简单 得 多 ， 后 者 只 有 一 条 
通用 的 规则 : 对 于 名 字 为 namey> 的 JSON 键 ， 用 户 只 需要 在 结构 里 创建 
一 个 任意 名 字 的 字段 ， 并 将 该 字段 的 结构 标签 设置 为 'json:" 
«name»"', 就 可 以 把 JSON 键 cname> 的 值 存储 到 这 个 字段 里 面 。 接 下 
来 ， 就 让 我 们 来 看 一 个 实际 的 例子 。 








代码 清单 7-9 展 示 了 一 个 名 为 post .json 的 JSON 文 件 ， 我 们 接 下 来 
就 要 对 这 个 文件 进行 分 析 。 因 为 这 个 JSON 文 件 包 含 的 数据 跟 之 前 分 析 
的 XML 文件 包含 的 数据 是 相同 的 ， 所 以 这 些 数据 对 你 来 说 应 该 不 会 感 
到 陌生 。 





代码 清单 7-9 ”要 分 析 的 JSON 文 件 








PEUT. Sy 
"content" : "Hello World!", 
"author" : ( 
"au^ : 2, 
"name" : "Sau Sheong" 
); 
"comments" : [ 


{ 


"id" : 3, 


"content" : "Have a great day!", 
"author" : "Adam" 

Js 

{ 
"id" : 4, 
"content" : “How are you today?", 
"author" : "Betty" 

} 





代码 清单 7-10 展 示 了 json.go 文 件 包 会 的 代码 ， 这 些 代 码 会 分 析 
post.json 文件 ， 并 将 其 包含 的 JSON 数 据 解 封 至 相应 的 结构 。 需 要 注 
意 的 是 ， 除 了 结构 标签 之 外 ， 这 个 程序 使 用 的 结构 跟 之 前 分 析 XML 时 
使 用 的 结构 并 无 不 同 。 


代码 清单 7-10 ” JSON 分 析 程 序 











package main 


import ( 
"encoding/json" 
"fmt" 
"io/ioutil" 
"os" 
) 
type Post struct { 
Id int `json: "id e 
Content string ` json: "content" 
Author Author ` json: "author"` 


Comments []Comment `json:"comments"` 


type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 


Content string 'json:"content"' 
Author string '^json:"author"^ 


} 
func main() { 
jsonFile, err := os.Open("post.json") 
if err != nil { 
fmt.Println("Error opening JSON file:", err) 
return 
} 


defer jsonFile.Close() 
jsonData, err :- ioutil.ReadAll(jsonFile) 


if err != nil { 
fmt.Println("Error reading JSON data:", err) 
return 

} 


var post Post 
json.Unmarshal(jsonData, &post) ©@ 
fmt.Println(post) 








Q 定义 一 些 结构 ， 用 于 表示 数据 


四 将 JSON 数据 解 封 至 结构 


为 了 将 JSON 键 id 的 值 映射 到 Post 结构 的 Id 字段 ， 程 序 将 该 字段 
的 结构 标签 设置 成 了 'json:"id"'， 这 种 设置 基本 上 就 是 将 结构 映射 
至 JSON 数 据 所 需 完成 的 全 部 工作 。 跟 分 析 XML 时 一 样 ， 分 析 程 序 通 过 
切片 来 散 套 多 个 结构 ， 从 而 使 一 篇 帖子 可 以 包含 零 个 或 多 个 评论 。 除 此 
之 外 ，JSON 的 解 封 操 作 也 跟 XML 的 解 封 操作 一 样 ， 都 可 以 通过 调 
用 Unmarshal 函数 来 完成 。 





我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 分 析 程 序 : 


如 果 一 切 正常 ， 应 该 会 看 到 以 下 结果 : 


{1 Hello World! (2 Sau Sheong) [(3 Have a great day! Adam) (4 How are you 
today? Bettyj]) 


跟 分 析 XML 时 一 样 ， 用 户 除 了 可 以 使 用 Unmarshal 函数 来 解 封 
JSON， 还 可 以 使 用 Decoder 手动 地 将 JSON 数 据 解 码 到 结构 里 面 ， 以 此 
来 处 理 流 式 的 JSON 数 据 ， 图 7-8 以 及 代码 清单 7-11 展 示 了 这 个 过 程 的 具 
体 实现 。 





图 7-8 ”使 用 Go 分 析 JSON: 将 JSON 解 码 至 结构 


代码 清单 7-11 使 用 Decoder 对 JSON 进 行 语言 分 析 








jsonFile, err := os.Open("post.json") 
if err !- nil ( 
fmt.Println("Error opening JSON file:", err) 
return 
} 
defer jsonFile.Close() 
decoder := json.NewDecoder(jsonFile) e 
for ( e 
var post Post 
err :- decoder.Decode(&post) e 
if err -- io.EOF ( 
break 
j 
if err !- nil ( 
fmt.Println("Error decoding JSON:", err) 
return 


fmt.Println(post) 
j 


[CC SR 
@ 根据 给 定 的 JSON 文件 ， 创 建 出 相应 的 解码 器 


O 遍历 JSON 文件 ， 直 到 遇见 EOF 为 止 
Q9 将 JSON 数据 解码 至 结构 


通过 调用 NewDecoder 并 传 入 一 个 包含 JSON 数 据 的 io.Reader , 
程序 创建 出 了 一 个 新 的 解码 器 。 在 把 指向 Post 结构 的 引用 传递 给 解码 
器 的 Decode 方法 之 后 ， 被 传 入 的 结构 就 会 填充 上 相应 的 数据 ， 然 后 这 
些 数据 就 可 以 为 程序 所 用 了 。 当 所 有 JSON 数 据 都 被 解码 完毕 
时 ，Decode 方法 将 会 返回 一 个 EOF ， 而 程序 则 会 在 检测 到 这 个 EOF 之 
后 退出 for 循环 。 





我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 解 码 器 : 


如 傈 一 切 正 凶 ， 将 会 看 到 以 下 结果 : 


(1 Hello World! (2 Sau Sheong} [{1 Have a great day! Adam) (2 How are you 
today? Bettyj]) 


最 后 ， 在 面 对 JSON 数 据 时 ， 我 们 可 以 根据 输入 决定 使 用 Decoder 
还 是 Unmarshal : 如 果 JSON 数 据 来 源 于 io.Reader 流 ， 如 
http.Request 的 Body ， 那 么 使 用 Decoder 更 好 ; 如 果 JSON 数 据 来 源 
于 字符 串 或 者 内 存 的 某 个 地 方 ， 那 么 使 用 Unmarshal 更 好 。 


7.5.2 ”创建 JSON 


正如 上 一 个 小 节 所 示 ， 分 析 JSON 的 方法 和 分 析 XML 的 方法 是 非常 
相似 的 。 同 样 地 ， 如 图 7-9 所 示 ， 创 建 JSON 的 方法 和 创建 XML 的 方法 也 
是 相似 的 。 





图 7-9 ”使 用 Go 创建 JSON: 创建 结构 并 将 其 封装 为 JSON 数 据 
代码 清单 7-12 展 示 了 把 Go 结构 封装 为 JSON 数 据 的 具体 代码 。 


代码 清单 7-12 ”将 结构 封装 为 JSON 





package main 


import ( 
"encoding/json" 
"fmt" 
"io/ioutil" 
) 
type Post struct (. e 
Id int `json:"id"` 
Content string ` json: "content" 
Author Author ` json: "author" 
Comments []Comment `json:"comments"` 
} 
type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 
j 


type Comment struct { 
Id int `json: "id" 


Content string 'json:"content"' 
Author string 'json:"author"^ 


} 


func main() { 
post := Post{ 
Id: 1, 
Content: "Hello World!", 
Author: Author( 
Id: 2, 
Name: "Sau Sheong", 


); 
Comments: []Comment( 
Comment ( 
Id: 35 
Content: "Have a great day!", 
Author: "Adam", 
); 
Comment 1 
Id: 4, 
Content: "How are you today?", 
Author: "Betty", 
); 
); 
j 
output, err := json.MarshalIndent(&post, "", "NtNt") e 
if err != nil { 
fmt.Println("Error marshalling to JSON:", err) 
return 
} 
err = ioutil.WriteFile("post.json", output, 0644) 
if err !- nil { 
fmt.Println("Error writing JSON to file:", err) 
return 
} 
} 





O 创建 结构 并 向 里 面 填充 数据 





O 把 结构 封装 为 由 字 节 切片 组 成 的 JSON 数据 


跟 处 理 XML 时 的 情况 一 样 ， 这 个 封装 程序 使 用 的 结构 和 之 前 分 析 


JSON 时 使 用 的 结构 是 相同 的 。 程 序 首 先 会 创建 一 


些 结构 ， 然 后 通过 调 





用 MarshalIndent % 
(json 库 的 MarshalIndent 也 
用 是 类 似 的 ) 。 


函数 将 结构 封装 为 由 字 节 切片 组 成 的 JSON 数 据 
函数 和 xml 库 的 MarshalIndent ?P 
最 后 ， 程 序 会 将 封装 所 得 的 JSON 数 据 存 储 到 指 


函数 的 作 
定 的 文 











fh 
正如 我 们 可 以 通 
TG 
E 创建 出 用 于 存储 
JSON 数 据 的 





图 7-10 ”使 用 Go 创建 JSON 数 据 : 





代码 清单 7-13 展 示 了 json. go 文件 中 包含 的 代码 ， 


过 编码 器 手动 创建 XML 一 样 ， 我 们 也 可 以 通过 编 
结构 编码 为 JSON 数 据 ， 图 7-10 展 示 了 这 个 过 程 





























通过 编码 器 把 
创建 出 用 于 编码 
JSON 数 据 的 编码 器 psv 
通过 编码 器 把 结构 编码 为 JSON 
这 些 代码 可 以 根 


据 给 定 的 Go 结构 创建 相应 的 JSON 文 件 。 


代码 清单 7-13 ”使 用 Encoder 把 结构 编码 为 JSON 








package main 


import ( 
"encoding/json" 
"fmt" 
"io" 
"os" 


) 


type Post struct (. e 


Id int `json:"id"` 

Content string ^json:"content"^ 

Author Author ^json:"author"^ 

Comments []Comment “json:"comments". 
j 


type Author struct { 


Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 


func main() { 


post := Post{ 
Id: 1, 
Content: “Hello World!", 
Author: Author{ 
Id: 2, 
Name: "Sau Sheong", 
) 
Comments: []Comment( 
Comment 1 
Id: 3, 
Content: "Have a great day!", 
Author: "Adam", 
); 
Comment 1 
Id: 4, 
Content: "How are you today?", 
Author: "Betty", 


); 
); 
); 
jsonFile, err := os.Create("post.json") e 
if err != nil { 
fmt.Println("Error creating JSON file:", err) 
return 
} 
encoder := json.NewEncoder(jsonFile) e 
err - encoder.Encode(&post) 
if err != nil( e 
fmt.Println("Error encoding JSON to file:", err) 
return 
} 


} 





@ 创建 结构 并 向 里 面 填充 数据 

e 创建 用 于 存储 数据 的 JSON 文件 

O 根据 给 定 的 JSON 文 件 创建 出 相应 的 编码 器 
O 把 结构 编码 到 JSON 文 件 里 面 


跟 之 前 一 样 ， 程 序 会 创建 一 个 用 于 存储 JSON 数 据 的 JSON 文 件 ， 并 
通过 把 这 个 文件 传递 给 NewEncoder 函数 来 创建 一 个 编码 器 。 接 着 ， 程 
这 会 调用 编码 器 的 Encode 方法 ， 并 同 其 传递 一 个 指 癌 Post 结构 的 引 
用 。 在 此 之 后 ，Encode 方法 会 从 结构 里 面 提取 数据 并 将 其 编码 为 JSON 
数据 ， 然 后 把 这 些 JSON 数 据 写 入 创建 编码 器 时 给 定 的 JSON 文 件 里 面 。 


关于 分 析 和 创建 XML 和 JSON 的 介绍 到 这 里 就 结束 了 。 虽 然 最 近 这 
两 节 介绍 的 内 容 可 能 会 因为 模式 相似 而 显得 有 些 乏 味 ， 但 这 些 基础 知识 
对 于 接 下 来 的 一 节 学 习 如 何 创建 Go Web 服 务 是 不 可 或 缺 的 ， 因 此 花 时 
间 学 习 和 掌握 这 些 知 识 是 非常 值得 的 。 





7.6 创建 Go Web 服 务 


创建 Go Web 服 务 并 不 是 一 件 困 难 的 事情 : 如 果 你 仔细 地 阅读 并 理 
解 了 前 面 各 个 章节 介绍 的 内 容 ， 那 么 掌握 接 下 来 要 介绍 的 知识 对 你 来 说 
应 该 是 轻而易举 的 。 








本 节 将 要 构建 一 个 简单 的 基于 REST 的 Web 服 务 ， 它 允许 我 们 对 论 
坛 帖子 执行 创建 、 获 取 、 更 新 以 及 删除 操作 。 有 具体 来 说 ， 我 们 将 会 使 用 


第 6 章 介 绍 过 的 CRUD 函 数 来 包 里 起 一 个 Web 服 务 接口 ， 并 通过 JSON 格 
式 来 传输 数据 。 除 了 本 章 之 外 ， 后 续 的 章节 也 会 沿用 这 个 Web 服 务 作为 
例子 ， 对 其 他 概念 进行 介绍 。 


代码 清单 7-14 展 示 了 实现 Web 服 务 需要 用 到 的 数据 库 操 作 ， 这 些 操 
作 和 6.4 节 介绍 过 的 操作 基本 相同 ， 只 是 做 了 一 些 简 化 。 这 些 代码 定义 
了 Web 服 务 需 要 对 数据 库 执行 的 所 有 操作 ， 它 们 都 隶属 于 main 包 ， 并 
且 被 放置 到 了 data.go 文 件 中 。 


























代码 清单 7-14 使 用 data.go 访问 数据 库 








package main 


import ( 

"database/sgl" 

_ "github.com/lib/pq" 
) 


var Db *sql1.DB 


func init() ( e 
var err error 
Db, err = sql.Open("postgres", "user-gwp dbname-gwp password-gwp sslmode 
disable") 
if err !- nil { 
panic(err) 
j 
} 


func retrieve(id int) (post Post, err error) ( e 
post = Posti) 
err - Db.QueryRow("select id, content, author from posts where id - $1", 
id).Scan(&post.Id, &post.Content, &post.Author) 
return 


} 


func (post *Post) create() (err error) { e 
statement :- "insert into posts (content, author) values ($1, $2) return 
ing 


id" 


stmt, err :- Db.Prepare(statement) 
if err != nil { 

return 
j 


defer stmt.Close() 
err - stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


j 


func (post *Post) update() (err error) ( e 
_, err = Db.Exec("update posts set content = $2, author = $3 where id = 
$1", post.Id, post.Content, post.Author) 
return 


} 


func (post *Post) delete() (err error) ( e 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 


} 





@ 连接 到 数据 库 

e 获取 指定 的 帖子 
e 创建 一 篇 新 帖子 
O 更 新 指定 的 帖子 
© 删除 指定 的 帖子 


正如 所 见 ， 这 些 代 码 跟 前 面 代 码 清单 6-6 展 示 过 的 代码 非常 相似 ， 
古 在 函数 名 和 方法 名 上 稍 有 区 别 ， 因 此 我 们 在 这 里 束 不 再 一 一 解释 
。 如 果 你 需要 重 温 一 下 这 些 代码 的 作用 ， 那 么 可 以 去 复习 一 下 6.4 








uoo 





在 拥有 了 对 数据 库 执 行 CRUD 操 作 的 能 力 之 后 ， 让 我 们 来 学 习 一 下 


如 何 实现 真正 的 Web 服 务 。 代 码 清单 7-15 展 示 了 整个 web 服 务 的 实现 代 
码 ， 这 些 代 码 保 存在 文件 server .go 中 。 








代码 清单 7-15 ”定义 在 server .go 文件 内 的 Go Web 服 务 

















package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 

) 


type Post struct { 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.HandleFunc("/post/", handleRequest) 
server.ListenAndServe() 


} 


func handleRequest(w http.ResponseWriter, r *http.Request) ( e 
var err error 
switch r.Method { 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err - handleDelete(w, r) 


j 

if err !- nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 

} 


} 


func handleGet(w http.ResponseWriter, r *http.Request) (err error) ( e 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err != nil { 
return 
j 
post, err :- retrieve(id) 
if err != nil { 
return 
j 
output, err := json.Marshallndent(&post, "", "NtNt") 
if err !- nil { 
return 
} 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 


} 


func handlePost(w http.ResponseWriter, r *http.Request) (err error) { e 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) 
var post Post 
json.Unmarshal(body, &post) 
err - post.create() 


if err != nil { 
return 

} 

w.WriteHeader(200) 

return 


} 


func handlePut(w http.ResponseWriter, r *http.Request) (err error) ( e 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err !- nil { 
return 
} 


len := r.ContentLength 

body := make([]byte, len) 
r.Body.Read(body) 
json.Unmarshal(body, &post) 
err - post.update() 


if err != nil { 
return 

j 

w.WriteHeader(200) 

return 


} 


func handleDelete(w http.ResponseWriter, r *http.Request) (err error) ( e 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err !- nil { 
return 

} 

post, err := retrieve(id) 

if err != nil { 
return 

} 

err = post.delete() 

if err != nil { 
return 

} 

w.WriteHeader(200) 

return 

} 





O 多 路 复 用 器 负责 将 请 求 转发 给 正确 的 处 理 器 函数 


e 获取 指定 的 帖子 
e 创建 新 的 帖子 
O 更 新 指定 的 帖子 


© 删除 指定 的 帖子 





这 段 代 码 的 结构 非常 直观 : handleRequest 多 路 复 用 器 会 根据 请 
求 使 用 的 HITP 方 法 ， 把 请 求 转发 给 相应 的 CRUD 处 理 器 函数 ， 这 些 函 
数 都 接受 一 个 ResponseNriter 和 一 个 Request 作为 参数 ， 并 返回 可 能 


出 现 的 错误 作为 函数 的 执行 结果 ; handleRequest 会 检查 这 些 函 数 的 
执行 结果 ， 并 在 发 现 错误 时 通过 statusInternalServerError 返回 一 
个 500 状 态 码 。 


接 下 来 ， 让 我 们 首先 从 帖子 的 创建 操作 开始 ， 对 Go Web 服 务 的 各 
个 部 分 进行 详细 的 解释 ，handlePost 函数 如 代码 清单 7-16 所 示 。 























代码 清单 7-16 用 于 创建 帖子 的 函数 


func handlePost(w http.ResponseWriter, r *http.Request) (err error) { 
len := r.ContentLength 
body := make([]byte, len) ee 
r.Body.Read(body) 
var post Post 
json.Unmarshal(body, &post) e 
err = post.create() o 
if err != nil { 
return 


w.WriteHeader(200) 
return 





€) 读 取 请 求 主 体 ， 并 将 其 存储 在 字 节 切片 中 ; @ 创 建 一 个 字 市 切片 
© 把 切片 存储 的 数据 解 封 至 Post 结构 
O 创建 数据 库 记 录 


handlePost 函数 首先 会 根据 内 容 的 长 度 创建 出 一 个 字 节 切片 ， 然 
后 将 请 求 主体 记录 的 JSON 字 符 串 读 取 到 字 节 切片 里 面 。 之 后 ， 函 数 会 
声明 一 个 Post 结构 ， 并 将 字 节 切片 存储 的 内 容 解 封 到 这 个 结构 里 面 。 
这 样 一 来 ， 函 数 就 拥有 了 一 个 填充 了 数据 的 Post 结构 ， 于 是 它 调 用 结 


构 的 Create 方法 ， 把 记录 在 结构 中 的 数据 存储 到 了 数据 库 里 面 。 


为 了 调用 web 服务， 我 们 需要 用 到 第 3 章 介绍 过 的 cCURL， 并 在 终端 
中 执行 以 下 命令 : 


curl -i -X POST -H "Content-Type: application/json" -d '("content":"My fi 
rst 


wepost","author":"Sau Sheong"}' http://127.0.0.1:8080/post/ 





这 个 命令 首先 会 把 Content -Type ces on 
， 然 后 通过 POST 方法 ， 向 地 址 http://127.6.6.1/post/ 发 送 一 条 主 
体 为 JSON 字 符 串 的 HTTP 请求。 如 果 一 切 顺利 ， 应 该 会 看 到 以 下 结果 : 


HTTP/1.1 200 OK 
Date: Sun, 12 Apr 2015 13:32:14 GMT 


Content-Length: 6 
Content-Type: text/plain; charset-utf-8 





不 过 这 个 结果 只 能 证 明 处 理 器 函数 在 处 理 这 个 请 求 的 时 候 没 有 发 生 
任何 错误 ， 却 无 法 说 明 帖 子 真 的 已 经 创建 成 功 了 。 为 了 验证 这 一 点 ， 我 
们 需要 通过 执行 以 下 SQL 碍 询 来 检视 一 下 数据 库 : 


psql -U gwp -d gwp -c "select * from posts;" 


如 果 帖 子 创建 成 功 了 ， 应 该 会 看 到 以 下 结果 : 








1 | My first post | Sau Sheong 
(1 row) 





除了 handlePost 函数 之 外 ， 我 们 的 Web 服 务 的 每 个 处 理 器 函数 都 
会 假设 目标 帖子 的 id 已 经 包含 在 了 URL 里 面 。 比 如 说 ， 当 用 户 想 要 获 
取 一 篇 帖子 时 ，Web 服 务 接收 到 的 请 求 应 该 指 癌 以 下 URL: 


/post/«id» 


而 这 个 URL 中 的 <id> iuok tea id 。 代 码 清单 7-17 展 示 了 函数 
是 如 何 通 过 这 一 机 制 来 获取 帖子 的 。 














代码 清单 7-17 用 于 获取 帖子 的 函数 


























func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err != nil { 
return 
j 
post, err :- retrieve(id) e 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") e 
if err !- nil 
return 


} 


w.Header().Set("Content-Type", "application/json") e 
w.Write(output) 
return 





@ 从 数据 库 里 获取 数据 ， 并 将 其 填充 到 Post 结构 中 
© 把 Post 结构 封装 为 JSON FIFE 


© 把 JSON 数据 写 入 ResponseWriter 


handleGet 函数 首先 通过 path.Base 函数 ， 从 URE 的 路 径 中 提取 
出 字符 串 格 式 的 帖子 id ， 接 着 使 用 strconv.Atoi 函数 把 这 个 id 转换 
成 整数 格式 ， 然 后 通过 把 这 个 id 传递 给 retrivePost 函数 来 获得 填充 
了 帖子 数据 的 Post 结构 。 


在 此 之 后 ， 程 序 通过 json.MarshalIndent 函数 ， 把 Post 结构 转 
换 成 了 JSON 格 式 的 字 节 切片 。 最 后 ， 程 序 把 Content -Type 首部 设置 
成 了 application/json ， 并 把 字 节 切片 中 的 JSON 数 据 写 
AResponseWriter ， 以 此 来 将 JSON 数 据 返 回 给 调用 者 。 





为 了 观察 handleGet 函数 是 如 何 工 作 的 ， 我 们 需要 在 终端 里 面 执行 
E rar: 


curl -i -X GET http://127.0.0.1:8080/post/1 


这 条 命令 会 问 给 定 的 URL 发 送 一 个 GET 请 求 ， 尝 试 获取 id 为 1 的 帖 
子 。 如 果 一 切 正 常 ， 那 么 这 条 命令 应 该 会 返回 以 下 结 宁 : 


HTTP/1.1 200 OK 

Content-Type: application/json 
Date: Sun, 12 Apr 2015 13:32:18 GMT 
Content-Length: 69 


( 


"id": 1, 
"content": “My first post", 
"author": "Sau Sheong" 








在 更 新 帖子 的 时 候 ， 程 序 同样 需要 先 获取 帖子 的 数据 ， 具 体 细节 如 
代码 清单 7-18 所 示 。 














代码 清单 7-18 用 于 更 新 帖子 的 函数 


























func handlePut(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err !- nil ( 
return 
} 
post, err := retrieve(id) e 
if err != nil { 
return 
} 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) e 
json.Unmarshal(body, &post) e 
err - post.update() e 
if err != nil { 
return 


j 
w.WriteHeader(200) 
return 








@ 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 
O 从 请 求 主 体 中 读 取 JSON 数据 

© 把 JSON 数据 解 封 至 Post 结构 

O 对 数据 库 进 行 更 新 


在 更 新 帖子 时 ，handlePut 函数 首先 会 获取 指定 的 帖子 ， 然 后 再 根 
JE PUT 请 求 发 送 的 信息 对 帖子 进行 更 新 。 在 获取 了 帖子 对 应 的 Post Zi 
构 之 后 ， 程 序 会 读 取 请 求 的 主体 ， 并 将 主体 中 的 内 容 解 封 至 Post £i 
构 ， 最 后 通过 调用 Post 结构 的 update 方法 更 新 帖子 。 


通过 在 终端 里 面 执 行 以 下 命令 ， 我 们 可 以 对 之 前 创建 的 帖子 进行 更 


新 : 


curl -i -X PUT -H "Content-Type: application/json" -d '{"content":"Updated 


wepost","author":"Sau Sheong"}' http://127.0.0.1:8080/post/1 





需要 注意 的 是 ， 跟 使 用 POST 方法 创建 帖子 时 不 一 样 ， 这 次 我 们 需 
要 通过 URL 来 指定 被 更 新 帖子 的 ID。 如 果 一 切 正常 ， 这 条 命令 应 该 会 返 
回 以 下 结 


HTTP/1.1 266 OK 
Date: Sun, 12 Apr 2015 14:29:39 GMT 


Content-Length: 6 
Content-Type: text/plain; charset-utf-8 











现在 ， 我 们 可 以 通过 再 次 执行 以 下 SQL 会 询 来 确认 更 新 是 否 已 经 成 
功 : 


psql -U gwp -d gwp -c "select * from posts;" 


如 无 意外 ， 应 该 会 看 到 以 下 内 容 : 


1 | Updated post | Sau Sheong 
(1 row) 





代码 清单 7-19 展 示 了 Web 服 务 的 帖子 删除 操作 的 实现 代码 ， 这 些 代 
码 会 先 获 取 指 定 的 帖子 ， 然 后 通过 调用 delete 方法 来 删除 帖子 。 














代码 清单 7-19 用 于 删除 帖子 的 函数 














func handleDelete(w http.ResponseWriter, r *http.Request) (err error) ( 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err != nil { 
return 


j 

post, err :- retrieve(id) e 
if err != nil { 

return 


} 

err = post.delete() @ 
if err != nil { 

return 


w.WriteHeader(200) 
return 








O 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 





e 从 数据 库 里 删除 这 个 帖子 








注意 ， 无 论 是 更 新 帖子 还 是 删除 帖子 ，Web 服 务 在 操作 执行 成 功 时 
都 会 返回 200 状 态 码 。 但 是 ， 如 果 处 理 器 函数 在 处 理 请 求 时 出 现 了 任何 
音 误 ， 那 么 该 错误 将 被 返回 至 handleRequest 多 路 复 用 器 ， 然 后 由 多 
路 复 用 器 向 客户 端 返回 一 个 500 状 态 码 。 


通过 执行 下 面 的 cURE 调 用 ， 我 们 可 以 删除 前 面 创 建 的 帖子 : 


curl -i -X DELETE http://127.0.0.1:8080/post/1 


如 果 一 切 正常 ， 那 么 这 个 cURL 调用 将 返回 以 下 结果 : 





HTTP/1.1 266 OK 

Date: Sun, 12 Apr 2015 14:38:59 GMT 
Content-Length: 6 

Content-Type: text/plain; charset-utf-8 


[L E 
现在 ， 如 果 我 们 再 次 执行 之 前 的 SQL 但 询 ， 就 会 发 现 之 前 创建 的 帖 
子 已 经 不 复 存 在 了 : 





id | content | author 
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。 编写 Web 服务 是 Go 语言 目前 非常 常见 的 用 途 之 一 ， 了 解 如 何 构建 
Web 服 务 是 一 项 非常 有 价值 的 技能 。 

。 Web 服 务 主要 分 为 两 种 类 型 一 一 一 种 是 基于 SOAP 的 Web 服 务 ， 而 
另 一 种 则 是 基于 REST 的 Web 服 务 。 

o SOAP 是 一 种 协议 ， 它 能 够 对 定义 在 XML 中 的 结构 化 数据 进行 
交换 。 但 是 ， 因 为 SOAP 的 WSDL 报 文 有 可 能 会 变 得 非常 复 
杂 ， 所 以 基于 SOAP 的 Web 服 务 没有 基于 REST 的 Web 服 务 那么 
流行 。 
基于 REST 的 Web 服 务 通过 HTTP 协 议 向 外 界 公开 自己 拥有 的 资 
源 ， 并 人 允许 外 界 通过 HTTP 协 议 对 这 些 资源 执行 指定 的 动作 。 
。 创建 和 分 析 XML 以 及 JSON 的 步骤 都 是 相似 的 ， 用 户 要 么 根据 指定 

的 结构 去 生成 XML 或 者 JSON， 要 么 从 指定 的 结构 里 面 提 取 数 据 到 
XML 或 者 JSON 里 面 ， 前 一 种 操作 称 为 封装 ， 而 后 一 种 操作 则 称 为 


解 封 。 








o 


[1] SOAP API 的 搜集 结果 可 以 通过 访问 
www.programmableweb.com/category/all/apis?data format-21176 查看 ， 
而 REST API 的 搜集 结果 可 以 通过 访问 


www.programmableweb.com/category/all/apis?data format- 21190 查 看 。 


[2] 具体 化 指 的 古 将 抽象 的 概念 转换 为 实际 的 数据 模型 或 对 象 。 一 一 译 
者 注 


第 8 草 ”应 用 训 试 


本 章 主要 内 容 


e Go 语言 的 testing 库 
e. 单元 测试 

e HTTP 测 试 

。 使 用 依赖 注入 进行 测试 
。 使 用 第 三 方 测试 库 


测试 是 编程 工作 中 非常 重要 的 一 环 ， 但 很 多 人 却 忽视 了 这 一 点 ， 叉 
或 者 只 是 把 测试 看 作 是 一 种 可 有 可 无 的 补充 手段 。Go 语 言 提 供 了 一 些 
基本 的 测试 功能 ， 这 些 功 能 初 看 上 去 可 能 会 显得 非常 原始 ， 但 正如 本 章 
将 要 介绍 的 那样 ， 这 些 工具 实际 上 已 经 能 够 满足 程序 员 对 自动 测试 的 需 
要 了 。 除 了 Go 语言 内 置 的 testing 包 之 外 ， 本 章 还 会 介绍 check 和 
Ginkgo 这 两 个 流行 的 Go 测试 包 ， 它 们 提供 的 功能 比 testing 包 更 为 丰 








mi} 


跟前 面 章 市 介绍 过 的 Web 应 用 编程 库 一 样 ，Go 语 言 的 测试 库 也 只 所 
供 了 基本 的 工具 ， 而 程序 员 要 做 的 就 是 在 这 些 工 具 的 基础 上 ， 构 建 出 能 
够 满足 目 己 需求 的 测试 。 





8.1 Go 与 测试 


Go 的 标准 库 提供 了 几 个 与 测试 有 关 的 库 ， 其 中 最 主要 的 是 testing 
包 ， 本 章 介 绍 的 绝 大 部 分 测试 功能 都 来 源 于 这 个 
包 。net/http/httptest 包 是 另 一 个 与 Web 应 用 编程 有 关 的 库 ， 这 个 
库 是 基于 testing 库 实 现 的 。 正 如 它 的 名 字 所 示 ，httptest 包 是 一 个 
用 于 测试 Web 应 用 的 库 。 


因为 testing 包 提供 了 在 Go 中 实现 基本 的 自动 测试 的 能 力 ， 所 以 
本 章 会 先 介绍 testing 包 ， 等 读者 了 解 了 testing 包 之 后 ， 再 学 
习 httptest 包 就 会 有 事半功倍 的 效果 。 


testing 包 需 要 与 go test 命令 以 及 源 代 码 中 所 有 以 _test.go 后 
级 结尾 的 测试 文件 一 同 使 用 。 尽 管 Go 并 没有 强制 要 求 ， 但 一 般 来 说 ， 
测试 文件 的 名 字 都 会 与 被 测 试 源码 文件 的 名 字 相 对 应 。 


举 个 例子 ， 对 于 源码 文件 server .go ， 我 们 可 以 创建 出 一 个 名 
为 server_test.go 的 测试 文件 ， 这 个 测试 文件 包含 我 们 想 对 
server.go 进行 的 所 有 测试 。 男 外 需要 注意 的 一 点 是 ， 被 测试 的 源码 文 
件 和 测试 文件 必须 位 于 同一 个 包 之 内 。 


为 了 测试 源 代码 ， 用 户 需 要 在 测试 文件 中 创建 具有 以 下 格式 的 测试 
函数 ， 其 中 Xxx 可 以 是 任意 瑞 文 字母 以 及 数字 的 组 合 ， 但 是 首 字 符 必须 
是 大 写 的 英文 字母 : 








func TestXxx 


(*testing.T) ( ... ) 





在 测试 函数 的 内 部 ， 用 户 可 以 使 用 Error 、Fail 等 一 系列 方法 表 


示 测 试 失 败 。 当 用 户 在 终端 里 面 执行 go test 命令 的 时 候 ， 所 有 符合 上 
述 格式 的 测试 函数 就 会 被 执行 。 如 果 一 个 测试 在 执行 时 没有 出 现任 何 失 
败 ， 那 么 我 们 就 说 函数 通过 了 测试 。 接 下 来 ， 就 让 我 们 实际 地 学 习 如 何 
使 用 testing 包 进 行 测试 。 


82 ”使 用 Go 进行 单元 测试 


顾名思义 ， 单 元 测试 《unit test) ， 就 是 一 种 为 验证 单元 的 正确 性 而 
设置 的 自动 化 测试 ， 一 个 单元 束 是 程序 中 的 一 个 模块 化 部 分 。 一 般 来 
说 ， 一 个 单元 通常 会 与 程序 中 的 一 个 函数 或 者 一 个 方法 相对 应 ， 但 这 并 
不 是 必须 的 。 程 序 中 的 一 个 部 分 能 人 否 独立 地 进行 测试 ， 是 评判 这 个 部 分 
能 否 被 归纳 为 “单元 ”的 一 个 重要 指标 。 一 个 单元 通常 会 接受 数据 作为 输 
入 并 返回 相应 的 输出 ， 而 单元 测试 用 例 要 做 的 就 是 同 单 元 传 入 数据 ， 然 
后 检查 单元 产生 的 输出 是 否 符合 预期 。 单 元 测试 通常 会 以 测试 套件 
(test suite) 的 形式 运行 ， 后 者 是 为 了 验证 特定 行为 而 创建 的 单元 测试 
用 例 集合 。 





Go 的 单元 测试 会 按照 功能 分 组 ， 并 放置 在 以 _test. go 为 后 级 的 文 
件 当 中 。 作 为 例子 ， 我 们 接 下 来 要 考虑 的 是 如 何 对 代码 清单 8-1 所 示 的 
main.go 文 件 中 的 decode 函数 进行 测试 。 


代码 清单 8-1 一 个 JSON 数 据 解码 程序 








package main 


import ( 
"encoding/json" 
"fmt" 
"os" 


) 


type Post struct ( 


Id int `json: "id" 
Content string ` json: "content"` 
Author Author ` json: "author"` 
Comments []Comment 'json:"comments"^ 


} 


type Author struct { 
Id int `json: "id" 
Name string 'json:"name"^ 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content"` 
Author string '^json:"author"^ 


} 
func decode(filename string) (post Post, err error) ( e 
jsonFile, err :- os.Open(filename) e 
if err != nil { e 
fmt.Println("Error opening JSON file:", err) e 
return e 
) e 
defer jsonFile.Close() e 
decoder := json.NewDecoder(jsonFile) e 
err - decoder.Decode(&post) e 
if err != nil { e 
fmt.Println("Error decoding JSON:", err) e 
return e 
)e 
return e 
)e 
func main() ( e 
., err := decode("post.json") e 
if err !- nil { 
fmt.Println("Error:", err) 
} 


} 





O 将 负责 解码 的 代码 重 构 到 单独 的 解码 函数 中 


这 个 程序 复 用 了 之 前 在 代码 清单 7-8 和 代码 清单 7-9 中 展示 过 的 JSON 
解码 程序 ， 但 是 它 并 没有 像 旧 程序 那样 把 所 有 逻辑 都 放 到 main 函数 里 
面 ， 而 是 将 旧 程 序 中 负责 打开 文件 并 对 其 进行 解码 的 部 分 重 构 到 了 单独 
的 decode 函数 里 面 ， 然 后 再 在 main 函数 中 调用 decode 函数 。 需 要 注 
意 的 是 ， 虽 然 程 序 员 在 大 部 分 时 间 里 关注 的 都 是 如 何 编写 代码 从 而 实现 
m 但 写 出 可 测试 的 代码 同样 也 是 非常 重要 的 。 为 了 做 到 

一 点 ， 程 序 员 通常 需要 在 编写 程序 之 前 对 程序 的 设计 进行 思考 ， 并 把 
xD T it 本 章 稍 后 将 对 这 一 点 进行 更 详细 的 说 
明 。 



































代码 清单 8-2 展 示 了 我 们 将 要 解码 的 JSON 文 件 ， 它 跟 第 7 章 中 被 解 
码 的 JSON 文 件 是 完全 一 样 的 。 











Afi E 





8-2 被 解码 的 post.json 文件 














"ld" $3, 
"content" : "Hello World!", 


" : "Sau Sheong" 


3 
"comments" : [ 


"id" : 3, 
"content" : "Have a great day!", 
"author" : "Adam" 


"id" : 4, 
"content" : "How are you today?", 
"author" : "Betty" 





代码 清单 8-3 展 示 了 负责 测试 main .go 文件 的 main_test.go 文 件 
































代码 清单 8-3 ”对 main.go 进行 测试 的 main_test.go 文件 








package main @ 


import ( 
"testing" 
) 


func TestDecode(t *testing.T) ( 
post, err :- decode("post.json") e 
if err !- nil { 
t.Error(err) 
} 
if post.Id I! = 1{ e 
t.Error("Wrong id, was expecting 1 but got", post.Id) e 
) e 
if post.Content !- "Hello World!" ( e 
t.Error("Wrong content, was expecting 'Hello World!' but got", 
w.post.Content) 
} 
} 
func TestEncode(t *testing.T) { 
t.Skip("Skipping encoding for now") e 





O 测试 文件 与 被 测试 的 源 代码 文件 位 于 同一 个 包 内 

e 调用 被 测试 的 函数 

O 检查 结果 是 否 和 预期 的 一 样 ， 如 果 不 一 样 就 显示 一 条 出 错 信 息 
€ 哲 时 跳 过 对 编码 函数 的 测试 


这 个 测试 文件 与 被 测试 的 源码 文件 位 于 同一 个 包 内 ， 它 唯一 导入 并 
使 用 的 包 为 testing &. rm TestDecode 是 一 个 测试 用 例 ， 它 代表 的 


是 对 decode 函数 的 单元 测试 。TestDecode 接受 一 个 指向 testing.T 
结构 的 指针 作为 参数 ， 该 结构 是 testing 包 中 两 个 主要 结构 之 一 ， 当 被 
测试 函数 的 输出 结果 未 如 预期 时 ， 用 户 就 可 以 使 用 这 个 结构 来 产生 相应 
的 失败 (failure) 以 及 错误 (error) 。 


testing.T 结构 拥有 几 个 非常 有 用 的 函数 : 


。 Log 一 一 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 与 fnt.Println 类 
似 ; 

。 Logf 一 一 根据 给 定 的 格式 ， 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 
与 fmt.Printf 类 似 ; 

e Fail 一 一 将 测试 函数 标记 为 “已 失败 ”， 但 允许 测试 函数 继续 执 
行 ; 

e FailNow 一 一 将 测试 函数 标记 为 “已 失 败 ” 并 停止 执行 测试 函数 。 








除 以 上 4 个 函数 之 外 ，testing.T 结构 还 提供 了 图 8-1 所 示 的 一 些 便 
利 函 数 〈convenience function) ， 这 些 便利 函数 都 是 由 以 上 4 个 函数 组 合 


而 成 的 。 

















图 8-1 testing.T 结构 提供 的 各 个 函数 ， 每 个 格子 都 表示 一 个 函数 ， 其 中 位 于 白色 格子 内 的 函 
数 为 便利 函数 ， 它 们 由 位 于 灰色 格子 内 的 函数 组 合 而 成 。 例 如 ，Error 函数 是 Log 函数 和 Fail 
函数 的 组 合 函数 ， 它 在 被 调用 时 ， 会 先 调用 Log 函数 ， 然 后 再 调用 Fail 函数 























在 图 8-1 中 ， 组 合 函 数 Error 将 会 先后 调用 Log 函数 和 Fail 函数 ， 
而 组 合 函数 Fatal 则 会 先后 调用 Log 函数 和 FailNow 函数 。 


在 测试 函数 TestDecode 内 部 ， 程 序 会 正常 地 调用 decode 函数 ， 
然后 对 函数 返回 的 结果 进行 检查 。 如 果 函 数 返 回 的 结果 和 预期 的 结果 不 
一 致 ， 那 么 程序 就 可 以 根据 情况 调用 Fail 、FailNow 、Error 

. Errorf 或 者 Fatalf 等 函数 。 正 如 之 前 所 说 ，Fail 函数 在 把 一 个 测 
试用 例 标 记 为 “已 失败 ?之 后 ， 会 允许 这 个 测试 用 例 继续 执行 ， 

但 FailNow 函数 则 会 更 严格 一 些 一 一 它 在 把 一 个 测试 用 例 标记 为 “已 失 
败 ” 之 后 会 立即 退出 ， 不 再 执行 这 个 测试 用 例 的 剩余 代码 。 无 论 是 Fail 
还 是 FailNow ， 它 们 都 只 会 对 上 自己 所 处 的 测试 用 例 产 生 影响 ， 比 如 ， 在 
上 面 的 例子 中 ，TestDecode 调用 的 Error 函数 就 只 会 对 TestDecode 
AE P^ ^E REUS; 











为 了 运行 TestDecode 测试 用 例 ， 我 们 需要 在 测试 文件 
main test.go 所 在 的 目录 中 执行 以 下 命令 : 


这 条 命令 会 执行 当前 目录 中 名 字 以 _test .go 为 后 级 的 所 有 文件 。 
当 我 们 在 名 为 unit_testing 的 目录 中 执行 这 个 命令 时 ， 它 将 产生 以 下 


可 惜 的 是 ， 这 个 结果 并 没有 给 出 多 少 有 用 的 信息 。 为 此 ， 我 们 可 以 








使 用 具体 〈verbose) 标志 -v 来 获得 更 详细 的 信息 ， 并 通过 上 履 兰 率 标志 - 
cover 来 获知 测试 用 例 对 代码 的 履 盖 率 : 


go test -v -cover 


执行 这 条 命令 将 得 到 以 下 结果 : 


RUN TestDecode 
- PASS: TestDecode (0.00s) 
=== RUN TestEncode 
-- SKIP: TestEncode (0.00s) 


main test.go:23: Skipping encoding for now 
PASS 
coverage: 46.7% of statements 
ok unit testing 90.004s 





8.2.1” 跳 过 测试 用 例 


代码 清单 8-3 在 同一 个 测试 文件 里 包含 了 两 个 测试 用 例 ， 第 一 个 是 
前 面 已 经 介绍 过 的 TestDecode ， 而 另 一 个 则 是 TestEncode 。 因 为 代 
码 清单 8-1 中 的 程序 并 未 实现 相应 的 编码 方法 ， 所 以 TestEncode 并 没有 
做 任何 实际 的 行为 。 程 序 员 在 进行 测试 驱动 开发 Ctest-driven 
development, TDD)》 的 时 候 ， 通 常会 让 测试 用 例 持 续 地 失败 ， 直 到 函数 
被 真正 地 实现 出 来 为 止 ; 但 是 ， 为 了 避免 测试 用 例 在 函数 尚未 实现 之 前 
一 直 打 印 烦 人 的 失败 信息 ， 用 户 也 可 以 使 用 testing.T 结构 提供 的 
Skip 也 数 ， 暂 时 跳 过 指定 的 测试 用 例 。 此 外 ， 如 果 某 个 测试 用 例 的 执 
行 时 间 非 常 长 ， 我 们 也 可 以 在 实施 完整 性 检查 (sanity check) 的 时 候 ， 
使 用 Skip 函数 跳 过 该 测试 用 例 。 





除了 可 以 直接 跳 过 整个 测试 用 例 ， 用 户 还 可 以 通过 向 go test 命令 


传 入 短暂 标志 -short ， 并 在 测试 用 例 中 使 用 某 些 条 件 逻 辑 来 跳 过 测试 
中 的 指定 部 分 。 注 意 ， 这 种 做 法 跟 在 go test 命令 中 通过 选项 来 选择 性 
地 执行 指定 的 测试 不 一 样 : 选择 性 执行 只 会 执行 指定 的 测试 ， 并 跳 过 其 
他 所 有 测试 ， 而 -short 标志 则 会 根据 用 户 编 写 测 试 代码 的 方式 ， 跳 过 
测试 中 的 指定 部 分 或 者 跳 过 整个 测试 用 例 。 





作为 例子 ， 让 我 们 来 看 一 下 如 何 通 过 -short 标志 来 避免 执行 一 个 
长 时 间 运 行 的 测 斌 用例。 首先 ， 在 main_test.go 文 件 中 导入 time 
包 ， 并 创建 一 个 新 的 测试 用 例 : 


func TestLongRunningTest(t *testing.T) { 
if testing.Short() ( 
t.Skip("Skipping long-running test in short mode") 


time.Sleep(10 * time.Second) 





如 果 用 户 给 定 了 -short 标志 ， 测 试用 例 TestLongRunningTest 
将 被 跳 过 ; 相反 ， 如 果 用 户 没 有 给 定 -short 标志 ， 那 
么 TestLongRunningTest 用 例 将 被 执行 ， 并 因此 导致 测试 过 程 休眠 10 
s。 现 在 ， 首 移 让 我 们 来 看 一 下 测试 用 例 在 一 般 情 况 下 是 如 何 运 行 的 : 
=== RUN TestDecode 
--- PASS: TestDecode (0.00s) 
=== RUN TestEncode 


--- SKIP: TestEncode (0.00s) 
main test.go:24: Skipping encoding for now 


--- RUN TestLongRunningTest 

--- PASS: TestLongRunningTest (10.00s) 
PASS 

coverage: 46.7% of statements 

ok unit testing 10.004s 





正如 我 们 所 料 ， 测 试 花 了 10 s 来 执行 TestLongRunningTest 测试 
用 例 。 现 在 ， 我 们 使 用 以 下 命令 再 次 运行 测试 : 


go test -v -cover -Short 


这 次 运行 测试 将 得 出 以 下 结果 : 


=== RUN TestDecode 
--- PASS: TestDecode (0.00s) 
=== RUN TestEncode 
--- SKIP: TestEncode (0.00s) 
main test.go:24: Skipping encoding for now 
=== RUN TestLongRunningTest 


--- SKIP: TestLongRunningTest (0.00s) 
main test.go:29: Skipping long-running test in short mode 
PASS 
coverage: 46.7% of statements 
ok unit testing 0.004s 





正如 结果 所 示 ， 长 时 间 运 行 的 测试 用 例 TestLongRunningTest 在 
这 次 测试 中 被 跳 过 了 。 


8.2.2 ”以 并 行 方式 运行 测试 


正如 之 前 所 说 ， 单 元 测试 的 目的 是 独立 地 进行 测试 。 尽 管 有 些 时 
候 ， 测 试 套件 会 因为 内 部 存在 依赖 关系 而 无 法 独立 地 进行 单元 测试 ， 但 
是 只 要 单元 测试 可 以 独立 地 进行 ， 用 户 束 可 以 通过 并 行 地 运行 测试 用 例 
来 提升 测试 的 速度 了 ， 本 市 的 内 容 将 癌 我 们 展示 如 何在 Go 中 实现 这 
点 。 


首先 ， 在 main_test. go 文件 所 在 的 目录 中 创建 一 个 名 
Jjparallel test.go 的 文件 ， 并 在 文件 中 键入 代码 清单 8-4 所 示 的 代 


个 。 











代码 清单 8-4 ”并 行 测试 











package main 


import ( 
"testing" 
"time" 


) 


func TestParallel 1(t *testing.T) ( e 
t.Parallel() e 
time.Sleep(1 * time.Second) 

j 


func TestParallel 2(t *testing.T) ( e 
t.Parallel() 
time.Sleep(2 * time.Second) 

} 


func TestParallel 3(t *testing.T) ( e 
t.Parallel() 
time.Sleep(3 * time.Second) 

j 





O 模拟 需要 耗 时 一 秒 钟 运行 的 任务 

© 调用 Parallel 函数 ， 以 并 行 方式 运行 测试 用 例 
O 模拟 需要 耗 时 2 秒 运行 的 任务 

O 模拟 需要 耗 时 3 秒 运行 的 任务 


这 个 程序 利用 time.Sleep 函数 ， 以 3 个 测试 用 例 分 别 模 拟 了 3 个 需 
要 耗 时 1s、2s 和 3s 来 运行 的 任务 ， 并 且 为 了 让 这 些 测试 用 例 能 够 以 并 行 
的 方式 运行 ， 程 序 还 在 每 个 测试 用 例 的 开头 调用 了 testing.T 结构 的 





Parallel 函数 。 


现在 ， 我 们 只 要 在 终端 中 执行 以 下 命令 ，Go 就 会 以 并 行 的 方式 运 
行 测 试 : 


go test -v -short -parallel 3 


这 条 命令 中 的 并 行 标志 -parallel 用 于 指示 Go 以 并 行 方式 运行 测 
试用 例 ， 而 参数 3 则 表示 我 们 希望 最 多 并 行 运行 3 个 测试 用 例 。 另 外 ， 
这 条 命令 还 使 用 了 -short 标志 ， 以 便 跳 过 main_test.go 测试 文件 中 
需要 长 时 间 运 行 的 测试 用 例 。 以 下 是 这 个 命令 的 执行 结 








=== RUN TestDecode 
--- PASS: TestDecode (0.00s) 
=== RUN TestEncode 
--- SKIP: TestEncode (0.00s) 
main test.go:24: Skipping encoding for now 
--- RUN TestLongRunningTest 
--- SKIP: TestLongRunningTest (0.00s) 
main test.go:30: Skipping long-running test in short mode 
RUN TestParallel 1 
RUN TestParallel 2 
RUN TestParallel 3 
- PASS: TestParallel 1 (1.00s) 
PASS: TestParallel 2 (2.00s) 
PASS: TestParallel 3 (3.00s) 


unit testing 3.006s 





从 这 个 结果 我 们 可 以 看 到 ，main_test.go 文 件 和 
parallel_test.go 文 件 中 的 所 有 测试 用 例 都 被 执行 了 ， 更 为 重要 的 
是 ，parallel_test.go 文 件 中 的 3 个 并 行 测试 用 例 被 同时 执行 了 : 尽 
管 这 3 个 并 行 测 试用 例 的 运行 时 长 各 有 不 同 ， 但 由 于 它们 是 同时 运行 





的 ， 所 以 这 3 个 测试 用 例 最 终 都 在 运行 时 长 最 长 的 测试 用 例 
TestParallel 3 的 执行 过 程 中 结束 了 ， 这 也 是 整个 测试 最 终 耗 绩 了 
3.006 s 的 原因 一 一 其 中 0.006 s 用 于 执行 main_test.go 中 的 前 几 个 测试 
用 例 ， 而 3 s 则 用 于 执行 parallel_test.go 中 运行 时 间 最 长 的 测试 用 例 
TestParallel 3. 








8.2.3 ”基准 测试 


Go 的 testing 包 文 持 两 种 类 型 的 测试 ， 一 种 是 用 于 检验 程序 功能 
性 的 功能 测试 〈functional testing) ， 而 另 一 种 则 是 用 于 查 明 任 务 单 元 性 
能 的 基准 测试 (benchmarking) 。 在 上 一 节 学 习 过 如 何 进行 功能 测试 之 
后 ， 这 一 节 我 们 将 要 学 习 如 何 进 行 基准 测试 。 








跟 单 元 测试 一 样 ， 基 准 测 试用 例 也 需要 放置 到 以 _test .go 为 后 级 
的 文件 中 ， 并 且 每 个 基准 测试 函数 都 需要 符合 以 下 格式 : 


func BenchmarkXxx(*testing.B) ( ... ) 


作为 例子 ， 代 码 清 单 8-5 展示 了 一 个 基准 测试 用 例 函 数 ， 这 个 函数 
定义 在 文件 pench_test.go 里 面 。 





代码 清单 8-5 ”基准 测试 








package main 


import ( 
"testing" 
) 


// benchmarking the decode function 
func BenchmarkDecode(b *testing.B) { 
for i:20; i < b.N; i++ { e 


decode("post.json") 
} 
} 





O 循环 执行 解码 函数 ， 以 便 对 其 进行 b.N 次 基准 测试 


正如 代码 所 示 ， 在 Go 语言 中 进行 基准 测试 是 非常 直 观 的 :测试 程 
厅 要 做 的 就 是 将 补 测 试 的 代码 执行 b.N 次 ， 以 便 准确 地 检测 出 代码 的 啊 
应 时 间 ， 其 中 b.N 的 值 将 根据 被 执行 的 代码 而 改变 。 比 如 ， 在 上 面 展 示 
的 基准 测试 例子 中 ， 测 试 程序 束 将 decode 函数 执行 了 b.N 次 。 


为 了 运行 基准 测试 用 例 ， 用 户 需 要 在 执行 go test 命令 时 使 用 基准 
测试 标志 -bench ， 并 将 一 个 正则 表达 式 用 作 该 标志 的 参数 ， 从 而 标识 
出 自己 想 要 运行 的 基准 测试 文件 。 当 我 们 需要 运行 目录 下 的 所 有 基准 测 
试 文件 时 ， 只 需要 把 点 〈.) 用 作 -bench 标志 的 参数 即 可 : 


go test -v -cover -Short -bench . 


下 面 是 这 条 命令 的 执行 结 











=== RUN TestDecode 

--- PASS: TestDecode (0.00s) 

=== RUN TestEncode 

--- SKIP: TestEncode (0.00s) 

main test.go:38: Skipping encoding for now 
--- RUN TestLongRunningTest 

--- SKIP: TestLongRunningTest (0.00s) 


main test.go:44: Skipping long-running test in short mode 
PASS 


BenchmarkDecode 100000 19480 ns/op 
coverage: 42.4% of statements 
ok unit testing 2.243s 





结果 中 的 169889 为 测试 时 b.N 的 实际 值 ， 也 就 是 函数 被 循环 执行 
的 次 数 。 在 这 个 例子 中 ， 友 代 进 行 了 10 万 次 ， 并 且 每 次 耗费 了 19480 
ns， 即 0.01948 ms。 需 要 注意 的 是 ， 在 进行 基准 测试 时 ， 测 试用 例 的 友 
代 次 数 是 由 Go 自行 决定 的 ， 虽 然 用 户 可 以 通过 限制 基准 测试 的 运行 时 
间 达 到 限制 迭代 次 数 的 目的 ， 但 用 户 是 无 法 直接 指定 从 代 次 数 的 一 一 测 
试 程序 将 进行 足够 多 次 的 迭代 ， 直 到 获得 一 个 准确 的 测量 值 为 止 。 在 
Go 1.5 中 ，test 子 命令 拥有 一 个 -test.count 标志 ， 它 可 以 让 用 户 指 
定 每 个 测试 以 及 基准 测试 的 运行 次 数 ， 该 标志 的 默认 值 为 1。 


注意 ， 上 面 的 命令 既 运 行 了 基准 测试 ， 也 运行 了 功能 测试 。 如 果 需 
要 ， 用 户 也 可 以 通过 运行 标志 -run 来 忽略 功能 测试 。-run 标志 用 于 指 

定 需要 被 执行 的 功能 测试 用 例 ， 如 果 用 户 把 一 个 不 存在 的 功能 测试 名 字 
用 作 -run 标志 的 参数 ， 那 么 所 有 功能 测试 都 将 被 忽略 。 比 如 ， 如 果 我 
们 执行 以 下 命令 : 


go test -run x -bench . 


那么 由 于 我 们 的 测试 中 不 存在 任何 名 字 为 x 的 功能 测试 用 例 ， 因 此 
所 有 功能 测试 都 不 会 被 运行 。 在 只 执行 基准 测试 的 情况 下 ，go test f 
令 将 产生 以 下 结 





PASS 
BenchmarkDecode 100000 19714 ns/op 
ok unit testing 2.150s 





2 e 数 的 运行 速度 非常 有 用 ， 但 如 果 我 们 能 够 对 比 两 个 
函数 的 运行 速度 ， 那 么 事情 无 疑 会 变 得 更 加 有 意义 ! 回想 一 下 ， 我 们 在 





第 7 章 曾 经 学 uu d de 吉 构 : 一 种 是 
使 用 Decode 函数 ， 男 a 函数 。 因 为 上 面 的 基准 
p e PRZEBSTIXEBE, MA POKGSLLE ALTES DUI 
一 下 Unmarshal 函数 的 运 e e 我 们 需 
要 像 代 人 码 清单 8-6 展 示 的 T 将 解 封 操作 的 代码 重 构 到 main.go 文 件 

的 unmarshal 函数 中 。 





代码 清单 8-6 ” 解 封 JSON 数 据 的 函数 





func unmarshal(filename string) (post Post, err error) { 
jsonFile, err := os.Open(filename) 
if err != nil { 
fmt.Println("Error opening JSON file:", err) 
return 


} 
defer jsonFile.Close() 


jsonData, err :- ioutil.ReadAll(jsonFile) 

if err != nil { 
fmt.Println("Error reading JSON data:", err) 
return 

j 

json.Unmarshal(jsonData, &post) 

return 





之 后 ， 我 们 还 需要 在 基准 测试 文件 bench_test. go 中 添加 代码 清 
单 8-7 所 示 的 基准 测试 用 例 ， 以 便 对 unmarshal 函 数 进 行 基准 测试 。 








代码 清单 8-7“” 对 unmarshal 函 数 进 行 基准 测试 

















func BenchmarkUnmarshal(b *testing.B) { 
for i:20; i < b.N; i++ { 
unmarshal("post.json") 


} 
} 





一 切 准 备 就 绪 之 后 ， 再 次 运行 基准 测试 命令 ， 我 们 将 得 到 以 下 结 
R: 
PASS 


BenchmarkDecode 100000 19577 ns/op 
BenchmarkUnmarshal 50000 24532 ns/op 


ok unit_testing 3.628s 





从 上 述 结果 可 以 看 到 ，Decode 函数 每 次 执行 需要 耗费 0.019577 
ms， 而 Unmarshal 函数 每 次 执行 需要 耗费 0.024532 ms， 这 说 
明 Unmarshal 函数 比 Decode rf ein 


8.3 ”使 用 Go 进行 HTTP 测 试 





因为 这 是 一 本 关于 Web 编 程 的 书 ， 所 以 我 们 除了 要 学 习 如 何 测试 普 
通 的 Go 程序 ， 还 需要 学 习 如 何 测试 Go Web 应 用 。 测 试 Go Web 应 用 的 方 
法 有 很 多 ， 但 是 在 这 一 节 中 ， 我 们 只 考虑 如 何 使 用 Go 对 Web 应 用 的 处 理 
器 进行 单元 测试 。 











对 Go Web 应 用 的 单元 测试 可 以 通过 testing/httptest 包 来 完 
成 。 这 个 包 提 供 了 模拟 一 个 Web 服 务 器 所 需 的 设施 ， 用 户 可 以 利 
用 net/http 包 中 的 客户 端 函 数 癌 这 个 服务 器 发 送 HTTP 请 求 ， 然 后 获取 
模拟 服务 器 返回 的 HTTP 响 应 。 


为 了 演示 httptest 包 的 使 用 方法 ， 我 们 会 复 用 之 前 在 7.14 节 展示 
过 的 简单 Web 服 务 。 正 如 之 前 所 说 ， 这 个 简单 Web 服 务 只 拥有 一 个 名 
为 handleRequest 的 处 理 器 ， 它 会 根据 请 求 使 用 的 HTTP 方法 ， 将 请 求 





多 路 复 用 到 相应 的 处 理 器 函数 。 举 个 例子 ， 如 果 handleRequest 接收 
到 的 是 一 个 HTTP GET 请 求 ， 那 么 它 会 把 该 请 求 多 路 复 用 到 handleGet 
函数 ， 代 码 清 单 8-8 展 示 了 这 两 个 函数 的 具体 定义 。 













































































代码 清单 8-8 负责 多 路 复 用 请 求 的 处 理 器 以 及 负责 处 理 请 求 的 GET 处 理 器 函数 






































func handleRequest(w http.ResponseWriter, r *http.Request) ( e 
var err error 
switch r.Method { e 
case "GET": 
err = handleGet(w, r) 
case "POST": 
err = handlePost(w, r) 
case "PUT": 
err = handlePut(w, r) 
case "DELETE": 
err - handleDelete(w, r) 
j 
if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 


} 
} 


func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err != nil { 
return 


} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 
} 
w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 





@ handleRequest 将 根据 请 求 使 用 的 HITP 方法 对 其 进行 多 路 复 用 
© 根据 请 求 使 用 的 HTTP 方法 ， 调 用 相应 的 处 理 器 函数 


代码 清单 8-9 展 示 了 一 个 通过 HTTP GET 请 求 对 简单 Web 服 务 进 行 单 
元 测试 的 例子 ， 而 图 8-2 则 展示 了 这 个 程序 的 整个 执行 过 程 。 











代码 清单 8-9 ”使 用 GET 请 求 进行 测试 





package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 

) 


func TestHandleGet(t *testing.T) { 
mux := http.NewServeMux() ©@ 
mux.HandleFunc("/post/", handleRequest) e 


writer :- httptest.NewRecorder() e 
request, _ := http.NewRequest("GET", "/post/1", nil) e 
mux.ServeHTTP(writer, request) e 


if writer.Code !- 200 ( e 
t.Errorf("Response code is Xv", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
t.Error("Cannot retrieve JSON post") 
} 
} 





O 创建 一 个 用 于 运行 测试 的 多 路 复 用 器 


e 绑 定 想 要 测试 的 处 理 需 


e 创建 记录 堪 ， 用 于 获取 服务 器 返回 的 HTTP 啊 应 
O 为 被 测试 的 处 理 器 创建 相应 的 请 求 
© 回 被 测试 的 处 理 器 发 送 请 求 


O 对 记录 器 记载 的 响应 结果 进行 检查 





因为 每 个 测试 用 例 都 会 独立 运行 并 启动 各 自 独 有 的 用 于 测试 的 Web 
服务 器 ， 所 以 程序 需要 创建 一 个 多 路 复 用 器 并 将 handleRequest 处 理 
器 与 其 进行 绑 定 。 除 此 之 外 ， 为 了 获取 服务 器 返回 的 HITP 响 应 ， 程 序 
使 用 httptest.New Recorder 函 数 创建 了 一 个 ResponseRecorder Zi 
构 ， 这 个 结构 可 以 把 响应 存储 起 来 以 便 进 行 后 续 的 检查 。 








与 此 同时 ， 程 序 还 需要 调用 http .NewRequest 函数 ， 并 将 请 求 使 
用 的 HTTP 方 法 、 被 请 求 的 URL 以 及 可 选 的 HTTP 请 求 主体 传递 给 该 函 
数 ， 从 而 创建 一 个 HITP 请 求 〈 在 第 3 章 和 第 4 章 ， 我 们 讨论 的 是 如 何 分 
析 一 个 HTTP 请 求 ， 而 创建 HITP 请 求 正 好 就 是 分 析 HITP 请 求 的 逆 操 
IE E 





创建 多 路 复 用 器 


将 被 测试 的 处 理 器 与 多 路 复 用 器 进行 绑 定 


创建 记录 器 


创建 请 求 


向 被 测试 的 处 理 器 发 送 请 求 ， 从 而 引发 对 记录 器 的 写 入 操作 





对 记录 器 记载 的 响应 结果 进行 检查 





图 8-2 使 用 Go 的 httptest 包 进 行 HTTP 测 试 的 具体 步 双 


程序 在 创建 出 相应 的 记录 器 以 及 HTTP 请 求 之 后 ， 就 会 使 
用 ServeHTTP 把 它们 传递 给 多 路 复 用 器 。 多 路 复 用 器 handleRequest 
在 接收 到 请 求 之 后 ， 就 会 把 请 求 转发 给 handleGet 函数 ， 然 后 
由 handleGet 函数 对 请 求 进行 处 理 ， 并 最 终 返 回 一 个 HTTP 响 应 。 跟 一 
般 服 务 器 不 同 的 是 ， 模 拟 服务 器 的 多 路 复 用 器 不 会 把 处 理 器 返回 的 响应 
发 送 至 浏览 器 ， 而 是 会 把 响应 推 入 响应 记录 器 里 面 ， 从 而 使 测试 程序 可 
以 在 之 后 对 响应 的 结果 进行 验证 。 测 试 程序 最 后 的 几 行 代码 非常 容易 看 











懂 ， 它 们 要 做 的 就 是 对 啊 应 进行 检查 ， 看 看 处 理 需 返回 的 结果 是 否 跟 预 
期 的 一 样 ， 并 在 出 现 意料 之 外 的 结果 时 ， 像 普通 的 单元 测试 那样 抛 出 一 


个 错误 。 





因为 这 些 操作 看 上 去 都 非常 简单 ， 所 以 不 妨 让 我 们 再 来 看 男 一 个 例 
子 一 一 代码 清单 8-10 展 示 了 如 何 为 PUT 请 求 创建 一 个 测试 用 例 。 














代码 清单 8-10 “对 PUT 请 求 进行 测试 





func TestHandlePut(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest) 


writer :- httptest.NewRecorder() 

json := strings.NewReader('^í("content":"Updated post","author":"Sau 
Sheong"} ) 

request, 


:= http.NewRequest("PUT", "/post/1", json) 
mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 
t.Errorf("Response code is Xv", writer.Code) 
j 
} 





正如 代码 所 示 ， 这 次 的 测试 用 例 除了 需要 问 请 求 传 入 JSON 数 据 ， 
跟 之 前 展示 的 测试 用 例 并 没有 什么 特别 大 的 不 同 。 除 此 之 外 你 可 能 会 注 
意 到 ， 上 述 两 个 测试 用 例 出 现 了 一 些 完全 相同 的 代码 。 为 了 保持 代码 的 
简洁 性 ， 我 们 可 以 把 一 些 重复 出 现 的 测试 代码 以 及 其 他 测试 夹具 
(fixture 〉 代 码 放 置 到 一 个 预 设 函 数 (setup function). 里 面 ， 然 后 在 运 
行 测试 之 前 执行 这 个 函数 。 


Go 的 testing 包 人 允许 用 户 通 过 TestMain 函数 ， 在 进行 测试 时 执行 
相应 的 预 设 〈setup) 操作 或 者 拆 和 外 (teardown) 操作 。 一 个 典型 的 


TestMain 函数 看 上 去 是 下 面 这 个 样子 的 : 


func TestMain(m *testing.M) { 
setUp() 
code := m.Run() 


tearDown() 
os.Exit(code) 


} 





setUp 函数 和 tearDown 了 水 数 分 别 定 义 了 测试 在 预 设 阶段 以 及 拆 缀 
阶段 需要 执行 的 工作 。 需 要 注意 的 是 ，setUp 函数 和 tearDown 函数 是 
为 所 有 测试 用 例 设置 的 ， 它 们 在 整个 测试 过 程 中 只 会 被 执行 一 次 ， 其 中 
setUp 函数 会 在 所 有 测试 用 例 被 执行 之 前 执行 ， 而 tearDown 函数 则 会 
在 所 有 测试 用 例 都 被 执行 完毕 之 后 执行 。 至 于 测试 程序 中 的 各 个 测试 用 
例 ， 则 由 testing.M 结构 的 Run 方法 负责 调用 ， 该 方法 在 执行 之 后 将 返 
回 一 个 退出 码 (exit code) ， 用 户 可 以 把 这 个 退出 码 传递 给 os.Exit K 
数 。 








代码 清单 8-11 展 示 了 测试 程序 使 用 TestMain 函数 之 后 的 样子 。 


代码 清单 8-11 使 用 httptest 包 的 TestMain 函数 











package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"os" 
"strings" 
"testing" 

) 


var mux *http.ServeMux 
var writer *httptest.ResponseRecorder 


func TestMain(m *testing.M) ( 
setUp() 
code := m.Run() 
os.Exit(code) 


} 


func setUp() { 
mux = http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest) 
writer = httptest.NewRecorder() 

j 


func TestHandleGet(t *testing.T) { 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 

t.Errorf("Response code is Xv", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 

t.Errorf("Cannot retrieve JSON post") 


} 
} 
func TestHandlePut(t *testing.T) { 
json := strings.NewReader(^("content":"Updated post","author":"Sau 
Sheong"} ) 
request, _ := http.NewRequest("PUT", "/post/1", json) 


mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 
t.Errorf("Response code is Xv", writer.Code) 
} 
} 





更 新 后 的 测试 程序 把 每 个 测试 用 例 都 会 用 到 的 全 局 变量 放 到 了 
setUp 函数 中 ， 这 一 修改 不 仅 让 测试 用 例 函 数 变 得 更 加 紧 竣 ， 而 且 还 把 
所 有 与 测试 用 例 有 关 的 预 设 操作 都 集中 a 到 了 一 起 。 但 是 ， 因 为 这 个 程序 
在 测试 之 后 不 需要 进行 任何 收尾 工作 ， 所 以 它 没有 配置 相应 的 拆 凶 函 





数 : 当 所 有 测试 用 例 都 运行 完毕 之 后 ， 测 试 程序 就 会 直接 退出 。 


上 面 展示 的 代码 只 测试 了 Web 服 务 的 多 路 复 用 器 以 及 处 理 器 ， 但 它 
并 没有 测试 web 服务 的 另 一 个 重要 部 分 。 你 也 许 还 记得 ， 在 本 书 的 第 7 
章 中 ， 我 们 曾经 从 Web 服 务 中 抽 离 出 了 数据 层 ， 并 将 所 有 数据 操作 代码 
都 放置 到 了 data.go 文 件 中 。 因 为 测试 handleGet 函数 需要 调用 Post 
结构 的 retrieve 函数 ， 而 测试 handlePut 函数 则 需要 调用 Post 结构 
的 retrieve 函数 以 及 update 函数 ， 所 以 上 述 测 试 程序 在 对 简单 Web 服 
务 进行 单元 测试 时 ， 实 际 上 是 在 对 数据 库 中 的 数据 执行 获取 操作 以 及 修 
改 操 作 。 











因为 被 测试 的 操作 涉及 依赖 关系 ， 所 以 上 述 单元 测试 实际 上 并 不 是 
独立 进行 的 ， 为 了 解决 这 个 问题 ， 我 们 需要 用 到 下 一 市 介绍 的 技术 。 


8.4 测试 蔡 身 以 及 依赖 注入 


测试 殖 身 Ctest double) 是 一 种 能 够 让 单元 测试 用 例 变 得 更 为 独立 
的 利用 方法 。 当 测试 不 方便 使 用 实际 的 对 象 、 结 构 或 者 函数 时 ， 我 们 束 
可 以 使 用 测试 蔡 身 来 模拟 它们 。 因 为 测试 蔡 身 能 够 提高 被 测试 代码 的 独 
六 性 ， 所 以 自动 单元 测试 环境 经 常会 使 用 这 种 技术 。 


测试 邮件 发 送 代码 是 一 个 需要 使 用 测试 于 号 的 场景 : 很 目 然 地 ， 你 
并 不 希望 在 进行 单元 测试 时 发 送 真正 的 邮件 ， 而 解决 这 个 问题 的 一 种 方 
法 ， 束 是 创建 出 能 够 模拟 邮件 及 送 操作 的 测试 符号 。 同 样 地 ， 为 了 对 简 
单 Web 服 务 进 行 单元 测试 ， 我 们 需要 创建 出 一 些 测试 殖 身 ， 并 通过 这 些 
蔡 吴 移 除 单元 测试 用 例 对 真实 数据 库 的 依赖 。 


测试 符号 的 概念 非常 直观 易 懂 一 一 程序 员 要 做 的 就 是 在 进行 目 动 测 
试 时 ， 创 建 出 测试 殖 身 并 使 用 它们 去 代 瞪 实际 的 函数 或 者 结构 。 然 而 问 
题 在 于 ， 使 用 测试 蔡 身 需要 在 编码 之 前 进行 相应 的 设计 : 如 果 你 在 设计 
程序 时 根本 没有 考 碟 过 使 用 测试 苦 身 ， 那 么 你 很 可 能 无 法 在 实际 测试 中 
使 用 这 一 技术 。 比 如 ， 上 一 节 展 示 的 简单 Web 服 务 的 设计 就 无 法 在 训 试 
中 创建 测试 谷 身 ， 这 是 因为 对 数据 库 的 依赖 已 经 深 深 地 扎根 于 这 些 代 码 
ra 

















实现 测试 蔡 身 的 一 种 设计 方法 是 使 用 依赖 注入 Cdependency 
injection) 设计 模式 。 这 种 模式 通过 同 被 调用 的 对 象 、 结 构 或 者 函数 传 
入 依赖 关系 ， 然 后 由 依赖 关系 代 蔡 被 调用 者 执行 实际 的 操作 ， 以 此 来 
解 耦 软件 中 的 两 个 或 多 个 层 〈layer) ， 而 在 Go 语言 当中 ， 被 传 入 的 依 
赖 关 系 通 常会 是 一 种 接口 类 型 。 接 下 来 ， 就 让 我 们 来 看 看 ， 如 何在 第 7 
章 介 绍 的 简单 Web 服 务 中 使 用 依赖 注入 设计 模式 。 


使 用 Go 实现 依赖 注入 


在 第 7 章 介 绍 的 简单 Web 服 务 中 ，handleRequest AHER RAAS 
将 GET 请 求 转发 给 handleGet 函数 ， 后 者 会 从 URL 中 提取 文章 的 ID， 然 
后 通过 data. go 文件 中 的 retrieve 函数 获取 与 文章 ID 相对 应 的 Post 
结构 。 当 retrieve 函数 被 调用 时 ， 它 会 使 用 全 局 的 sq1.DB 结构 去 打开 
一 个 连接 至 PostgreSQL 的 数据 库 连 接 ， 并 在 posts 表 中 查找 指定 的 数 
据 。 





图 8-3 展 示 了 简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 。 
除 retrieve 函数 需要 通过 全 局 的 sq1.DB 实例 访问 数据 库 之 外 ， 访 问 数 


据 库 对 于 其 他 函数 来 说 都 是 透明 的 (transparent) 。 
由 main 函 数 调用 


handleRequest 
handleGet 
(genie ) 






PostgreSQL 
Cs ni 


retrieve A 25 Er ftii] 
用 全 局 变量 sql.DB。 


图 8-3 ”简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 图 




















正如 图 8-3 所 示 ，handleRequest 和 handleGet 都 依赖 于 
retrieve 函数 ， 而 后 者 最 终 又 依赖 于 sql.DB 。 因 为 对 sq1.DB 的 依赖 
是 整个 问题 的 根源 ， 所 以 我 们 必须 将 其 移 除 。 





跟 很 多 问题 一 样 ， 解 耦 依 赖 关 系 也 存在 着 好 几 种 不 同 的 方式 : BERT 
以 从 底部 开始 ， 对 数据 抽象 层 的 依赖 关系 进行 解 厢 ， 人 然后 直接 获取 
sql.DB 结构 ， 也 可 以 从 顶部 开始 ， 将 sq1.DB 注入 到 handleRequest 
当中 。 本 节 要 介绍 的 是 后 一 种 方法 ， 也 就 是 以 自 顶 向 下 的 方式 解 耦 依赖 
XB E. 








图 8-4 展 示 了 移 除 对 sq1.DB 的 依赖 并 将 这 种 依赖 通过 主 程序 注入 函 


数 调用 流程 中 的 具体 方法 。 注 意 ， 问 题 的 关键 并 不 是 避免 使 用 sq1.DB 
， 而 是 避免 对 它 的 直接 依赖 ， 这 样 我 们 才能 够 在 测试 时 使 用 测试 奉 号 。 


由 main 男 数 调用 
main 函 数 通过 把 sql.DB 用 作 







rte Post 结 构 的 其 中 一 部 分 来 实 
EN A L 现 注入 ,因此 sql DB 对 于 其 
| f 他 函数 来 说 将 是 不 可 见 的 。 
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图 8-4 将 一 个 包含 sq1.DB 的 Post 结构 传递 到 函数 调用 流程 中 ， 以 此 来 对 简单 Web 服 务实 现 依 
赖 注入 模式 。 因 为 Post 结构 已 经 包含 了 sql.DB ， 所 以 调用 流程 中 的 所 有 函数 都 不 再 依 
赖 sq1 .DB 


正如 前 面 所 说 ， 为 了 解 耘 被 调用 函数 对 sql1.DB 的 依赖 ， 我 们 可 以 
将 sql.DB 注入 handleRequest ， 但 是 把 sq1.DB 实例 或 者 指 癌 sq1.DB 
的 指针 作为 参数 传递 给 handleRequest 对 解决 问题 是 没有 任何 帮助 
的 ， 因 为 这 样 做 只 不 过 是 将 问题 推 给 了 控制 流 的 上 游 。 作 为 奉 代 ， 我 们 
需要 将 代码 清单 8-12 所 示 的 Text 接口 传递 给 handleRequest 。 当 测试 
程序 需要 从 数据 库 里 面 获取 一 篇 文章 时 ， 它 可 以 调用 Text 接口 的 方 
法 ， 并 假设 这 个 方法 知道 自己 应 该 做 什么 以 及 应 该 返回 什么 数据 。 








代码 清单 8-12 ”传递 给 handleRequest 的 接口 


type Text interface { 
fetch(id int) (err error) 
create() (err error) 
update() (err error) 


delete() (err error) 


} 





接 下 来 ， 我 们 要 做 的 就 是 让 Post 结构 实现 Text 接口 ， 并 将 它 的 一 
个 字段 设置 成 一 个 指向 sq1l.DB 的 指针 。 为 了 让 Post 结构 实现 Text 接 
口 ， 我 们 需要 让 Post 结构 实现 Text 接口 拥有 的 所 有 方法 ， 不 过 由 于 代 
人 码 清单 8-12 中 定义 的 Text 接口 原本 就 是 根据 Post 结构 拥有 的 方法 定义 
而 来 的 ， 所 以 Post 结构 实际 上 已 经 实现 了 Text 接口 。 代 码 清单 8-13 展 
示 了 添加 新 字段 之 后 的 Post 结构 。 
































代码 清单 8-13 ”添加 了 新 字段 之 后 的 Post 结构 














type Post struct ( 
Db *sgl.DB 
Id int json:" id” 
Content string 'json:"content"' 
Author string '^json:"author"^ 


} 


[L E 


这 种 做 法 解决 了 将 sql.DB 直接 传递 给 handleRequest 的 问题 : FE 
序 并 不 需要 将 sql.DB 传递 给 被 调用 的 函数 ， 它 只 需要 和 之 前 一 样 ， 向 
被 调用 的 函数 传递 Post 结构 的 实例 即 可 ， 而 Post 结构 的 各 个 方法 也 会 
使 用 结构 内 部 的 sql1.DB 指针 来 代 茶 原本 对 全 局 变量 的 访问 。 因 
为 handleRequest 函数 还 是 和 以 前 一 样 ， 接 受 Post 结构 作为 参数 ， 所 
以 它 的 签名 不 需要 做 任何 修改 。 在 根据 新 的 Post 结构 做 相应 的 修改 之 
后 ，handleRequest 函数 如 代码 清单 8-14 所 示 。 





代码 清单 8-14 ”修改 后 的 handleRequest 函数 





func handleRequest(t Text) http.HandlerFunc ( e 
return func(w http.ResponseWriter, r *http.Request) ( e 
var err error 
switch r.Method { 
case "GET": 
err = handleGet(w, r, t) e 
case "POST": 
err = handlePost(w, r, t) 
case "PUT": 
err = handlePut(w, r, t) 
case "DELETE": 
err = handleDelete(w, r, t) 
j 
if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 


} 





Q (X Text 接口 


© 返回 带 有 正确 签名 的 函数 


Q 将 Text 接 口传 递 给 实际 的 处 理 需 





正如 代码 所 示 ， 因 为 handleRequest 函数 已 经 不 再 遵循 
ServeHTTP 方法 的 签名 规则 ， 所 以 它 已 经 不 再 是 一 个 处 理 器 函数 了 。 这 
使 我 们 无 法 再 使 用 HandleFunc 函数 把 它 与 一 个 URL 绑 定 在 一 起 了 。 


为 了 解决 这 个 问题 ， 程 序 再 次 使 用 了 本 书 第 3 章 中 介绍 过 的 处 理 器 
串联 技术 ， 让 handleRequest 返回 了 一 个 http.HandlerFunc 函数 。 


之 后 ， 程 序 在 main 函数 里 面 将 不 再 绑 定 handleRequest 函数 到 
URL， 而 是 直接 调用 handleRequest 函数 ， 让 它 返 回 一 
个 http.HandleFunc 函数 。 因 为 被 返回 的 函数 符合 HandleFunc 方法 
的 签名 要 求 ， 所 以 程序 就 可 以 像 之 前 一 样 ， 把 它 用 作 处 理 霹 并 与 指定 的 
URL 进 行 绑 定 。 代 码 清单 8-15 展 示 了 修改 后 的 main 函数 。 














代码 清单 8-15 “修改 后 的 main 函数 














func main() { 


var err error 
db, err := sql.Open("postgres", "user-gwp dbname-gwp password-gwp sslmod 
e= 
disable") 
if err != nil { 
panic(err) 


server := http.Server{ 
Addr: ":8080", 


} 
http.HandleFunc("/post/", handleRequest(&Post(Db: db})) e 
server.ListenAndServe() 


} 





Q 将 Post 结构 传递 给 handleRequest 函 数 ， 然 后 绑 定 函 数 返 回 的 处 理 
器 


注意 ， 程 序 通过 Post 结构 ， 以 间接 的 方式 将 指向 sq1.DB 的 指针 传 
递 给 了 handleRequest 函数 ， 这 就 是 将 依赖 天 系 注 入 handleRequest 
的 方法 。 代 码 清单 8-16 展 示 了 同样 的 依赖 关系 是 如 何 被 注入 handleGet 
函数 的 。 





代码 清单 8-16 ”修改 后 的 handleGet 函数 

















func handleGet(w http.ResponseWriter, r *http.Request, post Text) (err err 
or) ( e 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err != nil { 
return 
} 
err = post.fetch(id) @ 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 





@ 接受 Text 接口 作为 参数 
O 获取 数据 并 将 其 存储 到 Post 结构 


修改 后 的 handleGet 函数 跟 之 前 差不多 ， 主 要 区 别 在 于 现在 的 
handleGet 函数 将 直接 接受 Post 结构 ， 而 不 是 像 以 前 那样 在 内 部 创建 








Post 结构 。 除 此 之 外 ，handleGet 函数 现在 会 通过 调用 Post 结构 的 
fetch 方法 来 获取 数据 ， 而 不 必 再 调用 需要 访问 全 局 sql .DB 实例 的 
retrieve 函数 。 代 码 清单 8-17 展 示 了 Post 结构 的 fetch 方法 的 具体 定 























代码 清单 8-17 新 的 fetch 方法 

















func (post *Post) fetch(id int) (err error) ( 
err - post.Db.QueryRow("select id, content, author from posts where id - 
w$1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 


} 





这 个 fetch 方法 在 访问 数据 库 时 不 需要 使 用 全 局 的 sql .DB 结构 ， 
而 是 使 用 被 传 入 的 Post 结构 的 Db 字段 来 访问 数据 库 。 如 果 我 们 现在 编 
译 并 运行 修改 后 的 简单 Web 服 务 ， 那 么 它 将 和 修改 之 前 的 简单 Web 服 务 
一 样 正常 工作 。 不 同 的 地 方 在 于 ， 修 改 后 的 代码 已 经 移 除 了 对 全 局 的 
sql.DB 结构 的 依赖 。 





只 要 对 数据 库 的 依赖 还 深 埋 在 代码 之 中 ， 我 们 就 无 法 对 其 进行 独立 
的 测试 。 为 此 ， 我 们 在 上 面 伦 了 不 少 功夫 来 移 除 代码 中 的 依赖 ， 从 而 使 
单元 测试 用 例 可 以 变 得 更 为 独立 。 在 通过 外 部 代码 实现 依赖 注入 之 后 ， 
我 们 接 下 来 就 可 以 使 用 测试 伍 喘 对 程序 进行 测试 了 。 








因为 handleRequest 函数 能 够 接受 任何 实现 了 Text 接口 的 结构 ， 
所 以 我 们 可 以 创建 出 一 个 实现 了 Text 接口 的 测试 替身 ， 并 把 它 作为 传 
递 给 handleRequest 函数 的 参数 。 代 码 清单 8-18 展 示 了 一 个 名 
JjFakePost 的 测试 蔡 身 ， 以 及 它 为 了 满足 Text 接口 的 要 求 而 实现 的 几 





^E. 








代码 清单 8-18 FakePost 测试 替身 





package main 


type FakePost struct { 
Id int 
Content string 
Author string 

j 


func (post *FakePost) fetch(id int) (err error) { 
post.Id = id 
return 


} 


func (post *FakePost) create() (err error) ( 
return 


} 


func (post *FakePost) update() (err error) { 
return 


} 


func (post *FakePost) delete() (err error) { 
return 


} 





注意 ， 为 了 进行 测试 ，fetch 方法 会 把 所 有 传递 给 它 的 ID 都 设置 
为 FakePost 结构 的 ID。 此 外 ， 虽 然 FakePost 结构 的 其 他 方法 在 测试 
时 都 不 会 用 到 ， 但 是 为 了 满足 Text 接口 的 实现 要 求 ， 程 序 还 是 为 每 个 
方法 都 定义 了 一 个 没有 任何 实际 用 途 的 空 方法 。 为 了 保持 代码 的 清晰 ， 
这 些 测 试 蔡 身 代 码 被 放 到 了 doubles .go 文件 里 面 。 


接 下 来 ， 我 们 还 需要 在 server_test.go 文 件 里 为 handleGet 函数 
加 上 代码 清单 8-19 所 示 的 测试 用 例 。 














代码 清 





8-19 将 测试 蔡 身 依赖 注入 到 handleRequest 











func TestHandleGet(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest(&FakePost[))) e 


writer :- httptest.NewRecorder() 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 
t.Errorf("Response code is Xv", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
t.Errorf("Cannot retrieve JSON post") 
} 
} 





O 传 入 一 个 FakePost 结构 来 代替 Post 结构 





测试 用 例 现在 不 再 向 handleRequest 传递 Post 结构 ， 而 是 传递 一 
^*FakePost 结构 ， 这 个 结构 就 是 handleRequest 所 需 的 一 切 。 除 此 之 
外 ， 这 个 测试 用 例 跟 之 前 的 测试 用 例 没有 什么 不 同 。 





为 了 验证 测试 蔡 身 是 否 能 正常 工作 ， 我 们 可 以 在 关闭 数据 库 之 后 再 
次 运行 测试 用 例 。 在 这 种 情况 下 ， 旧 的 测试 用 例 将 会 因为 无 法 连接 数据 
库 而 失败 ， 而 使 用 了 测试 蔡 身 的 测试 用 例 则 因为 不 需要 实际 的 数据 库 而 
一 切 如 常 进行 。 这 也 意味 着 我 们 在 辛 苗 了 这 么 久之 后 ， 终 于 可 以 独立 地 
测试 handleGet 函数 了 。 





跟 之 前 的 测 斌 一样， 如 果 handleGet 函数 运作 正常 ， 那 么 测试 就 会 
通过 ;人 否则， 测试 融会 失败 。 需 要 注意 的 是 ， 这 个 测试 用 例 并 没有 实际 


测试 post 结构 的 fetch 方法 ， 这 是 因为 实施 这 种 测试 需要 对 posts X 
执行 预 设 操作 和 拆 缀 操作 ， 而 重复 执行 这 种 操作 会 在 测试 时 耗费 大 量 的 
时 间 。 这 样 做 的 另 一 个 好 处 是 隔离 了 Web 服 务 的 各 个 部 分 ， 使 程序 员 可 
以 独立 测试 每 个 部 分 ， 并 在 发 现 问题 时 更 准确 地 定位 出 错 的 部 分 。 因 为 
代码 总 是 在 不 断 地 演进 和 变化 当中 ， 所 以 能 够 做 到 这 一 扣 是 非常 重要 
的 。 在 代码 不 断 衍化 的 过 程 中 ， 我 们 必须 保证 后 续 添 加 的 部 分 不 会 对 前 
面 已 有 的 部 分 造成 破坏 。 








8.5 ”第 三 方 Go 测试 库 





testing 包 是 一 种 简单 且 高 效 的 测试 Go 程序 的 方法 ， 它 甚至 还 被 
用 于 验证 Go 自身 的 标准 库 ， 但 是 为 了 满足 一 些 领域 淘 望 拥有 更 多 功能 
的 要 求 ， 市 面 上 也 出 现 了 不 少 对 testing 包 进 行 增强 的 Go 测试 库 。 本 
节 将 对 Gocheck 和 Ginkgo 这 两 个 流行 的 Go 测试 库 进行 介绍 。Gocheck 是 
两 者 中 较为 简单 的 一 个 ， 它 整合 并 扩展 了 testing 包 ; Ginkgo 能 够 让 用 
户 在 Go 中 实现 行为 驱动 开发 ， 但 这 个 库 比 较 复 杂 ， 而 且 学 习 曲 线 也 比 
A BEI. 








85.1 Gocheck 测 试 包 简 介 





Gocheck 项 目 提 供 了 check 包 ， 这 个 包 是 基于 testing 包 构 建 的 一 
个 测试 框架 ， 并 且 提 供 了 一 系列 特性 来 填补 标准 testing 包 在 特性 方面 
的 空白 ， 这 一 系列 特性 包括 : 





e 以 套件 (suite〉 为 单位 对 测试 进行 分 组 ; 
e. 为 每 个 测试 套件 或 者 测试 用 例 分 别 设置 测试 夹具 ; 


e WAI Heu tras mJ E ; 
e 更 多 错误 报告 辅助 函数 ; 
e 5j testing 包 紧 密集 成 。 


下 载 并 安装 check 包 的 工作 非 第 简单 ， 可 以 通过 执行 以 下 命令 来 完 


成 : 


go get gopkg.in/check.v1 


代码 清单 8-20 展 示 了 使 用 check 包 测 试 简单 Web 服 务 的 方法 。 














代码 清单 8-20 使 用 check 包 的 server_test.go 














package main 


import ( 


) 


"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 

. "gopkg.in/check.v1" e 


type PostTestSuite struct () e 


func init() { 


} 


Suite(&PostTestSuite{}) © 


func Test(t *testing.T) ( TestingT(t) ) e 


func (s *PostTestSuite) TestHandleGet(c *C) ( 


mux := http.NewServeMux() 

mux.HandleFunc("/post/", handleRequest(&FakePost(1))) 
writer :- httptest.NewRecorder() 

request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


c.Check(writer.Code, Equals, 200) e 


var post Post e 
json.Unmarshal(writer.Body.Bytes(), &post) e 
c.Check(post.Id, Equals, 1) e 

} 





@ 导入 check 包 中 的 标识 符 ， 使 程序 可 以 以 不 带 前 缀 的 方式 访问 它 
们 


e 创建 测试 套件 
e 注册 测试 套件 
O 集成 testing € 


O 检查 语句 的 执行 结 





这 个 测试 程序 做 的 第 一 件 事 束 是 导入 包 。 需 要 特别 注意 的 是 ， 因 为 
程序 是 以 点 〈. 0 方式 导入 check 包 的 ， 所 以 包 中 所 有 被 导出 的 标识 符 
在 测试 程 友 里 面 都 可 以 以 不 币 前 级 的 方式 访问 。 





之 后 ， 程 序 创 建 了 一 个 测试 套件 。 测 试 套件 将 以 结构 的 形式 表示 ， 
这 个 结构 既 可 以 像 这 个 例子 中 展示 的 一 样 一 一 只 古 一 个 空 结构 ， 也 可 以 
在 结构 中 包含 其 他 字段 ， 这 一 点 在 后 面 将 会 有 更 详细 的 讨论 。 除 了 创建 
测试 套件 结构 之 外 ， 程 序 还 需要 把 这 个 结构 传递 给 Suite 函数 ， 以 便 对 
测试 倒 件 进行 注册 。 测 试 套件 中 所 有 遵循 TestXxx 格式 的 方法 都 会 被 看 
作 是 一 个 测试 用 例 ， 跟 之 前 一 样 ， 这 些 测试 用 例 也 会 在 用 户 运 行 测 试 时 
被 执行 。 





准备 工作 的 最 后 一 步 是 集成 testing 包 ， 这 一 点 可 以 通过 创建 一 个 


普通 的 testing 包 测 试用 例 来 完成 : 程序 需要 创建 一 个 格式 为 TestXxx 
的 函数 ， 它 接受 一 个 指向 testing.T 的 指针 作为 输入 ， 然 后 把 这 个 指针 
作为 参数 在 函数 体内 调用 TestingT 函数 。 


上 述 集成 操作 会 导致 所 有 用 Suite 函数 注册 了 的 测试 套件 被 运行 ， 
而 运行 的 结果 则 会 被 回 传 至 testing 包 。 在 一 切 预 设 操作 都 准备 妥当 之 
后 ， 程 序 接 下 来 就 可 以 定义 自己 的 测试 用 例 了 。 在 上 面 展 示 的 测试 套件 
当中 ， 有 一 个 名 为 TestHandleGet 的 方法 ， 它 接受 一 个 指向 C 类 型 的 指 
针 作 为 参数 ， 这 种 类 型 拥有 一 些 非 常 有 趣 的 方法 ， 但 是 由 于 篇 幅 的 关 
系 ， 本 节 无 法 详细 介绍 C 类 型 拥有 的 所 有 方法 ， 目 前 来 说 ， 我 们 只 需要 
知道 它 的 Check 方法 和 Assert 方法 能 够 验证 结果 的 值 就 可 以 了 。 











例如 ， 在 代码 清单 8-20 中 ， 测 试用 例会 使 用 Check 方法 检查 被 返回 
的 HTTP 代 码 是 否 为 200， 如 果 结 果 不 是 200， 那 么 这 个 测试 用 例 将 被 标 
记 为 “已 失败 ”， 但 测试 用 例会 继续 执行 直到 结束 ; 反之， 如 果 程 序 使 
用 Assert 来 代 蔡 Check ， 那 么 测试 用 例 在 失败 之 后 将 立即 返回 。 


使 用 Gocheck 实 现 的 测试 程序 同样 使 用 go test 命令 执行 ， 但 是 用 
户 可 以 使 用 check 包 专 有 的 特别 详细 〈extra verbose) 标志 -check.vv 
显示 更 多 细节 ; 


go test -check.vv 


下 面 是 这 条 命令 的 执行 结果 : 








START: server test.go:19: PostTestSuite.TestGetPost 
PASS: server test.go:19: PostTestSuite.TestGetPost 6.666s 
OK: 1 passed 


PASS 
OK gocheck 0.007s 


正如 结果 所 示 ， 带 有 特别 详细 标志 的 命令 给 我 们 提供 了 更 多 信息 ， 
其 中 包括 测试 的 启动 信息 。 虽 然 这 些 信息 对 于 目前 这 个 例子 没有 太 大 帮 
助 ， 但 是 在 之 后 的 例子 中 ， 我 们 将 会 看 到 这 些 信息 的 重要 之 处 。 


为 了 观察 测试 程序 在 出 错时 的 反应 ， 我 们 可 以 小 小 地 修改 一 
下 handleGet 函数 ， 把 以 下 这 个 会 抛 出 HTTP 404 状 态 码 的 语句 添加 到 
函数 的 return 语句 之 前 : 


http.NotFound(w, r) 


现在 ， 再 执行 go test 命令 ,我 们 将 看 到 以 下 结果 : 


START: server test.go:19: PostTestSuite.TestGetPost 
server test.go:29: 
c.Check(post.Id, Equals, 1) 
. obtained int = 6 
. expected int = 1 


FAIL: server test.go:19: PostTestSuite.TestGetPost 


OOPS: 0 passed, 1 FAILED 
--- FAIL: Test (0.00s) 
FAIL 

exit status 1 


FAIL gocheck 0.007s 





正如 结果 所 示 ， 带 有 特别 详细 标志 的 go test 命令 在 测试 出 错时 将 
给 我 们 提供 非常 多 有 价值 的 信息 。 





测试 夹具 (test fixture) 是 check 包 提 供 的 另外 一 个 非常 有 用 的 特 
性 ， 用 户 可 以 通过 这 些 夹具 在 测试 开始 之 前 设置 好 固定 的 状态 ， 然 后 再 
在 测试 中 对 预期 的 状态 进行 检查 。 





check 包 为 整个 测试 套件 以 及 每 个 测试 用 例 分 别提 供 了 一 系列 预 设 
函数 和 拆伙 函 数 。 比 如 ， 在 套件 开始 运行 之 前 运行 一 次 的 SetUpSsuite 
函数 ， 在 所 有 测试 都 运行 完毕 之 后 运行 一 次 的 TearDownSuite rm Zi, 
在 运行 每 个 测试 用 例 之 前 都 会 运行 一 次 的 SetUpTest 函数 ， 以 及 在 运行 
每 个 测试 用 例 之 后 都 会 运行 一 次 的 TearDownTest 函数 。 





为 了 演示 这 些 测试 夹具 的 使 用 方法 ， 我 们 需要 复 用 之 前 展示 过 的 测 
试 程序 ， 并 为 PUT 方法 添加 一 个 测评 用例。 如果 我 们 仔细 地 观察 已 有 的 
测试 用 例 和 新 添加 的 测试 用 例 束 会 发 现 ， 在 每 个 测试 用 例 里 面 ， 都 出 现 
了 以 下 重复 代码 : 





mux := http.NewServeMux() 
mux.HandleFunc("/post/", handlePost(&FakePost())) 


writer :- httptest.NewRecorder() 





这 个 测试 程序 的 每 个 测试 用 例 都 会 创建 一 个 多 路 复 用 器 ， 并 调用 多 
路 复 用 器 的 HandleFunc 方法 ， 把 一 个 URL 和 一 个 处 理 器 绑 定 起 来 。 在 
此 之 后 ， 测 试用 例 还 需要 创建 一 个 ResponseRecorder 来 记录 请 求 的 响 
应 。 因 为 测试 套件 中 的 每 个 测试 用 例 都 需要 执行 这 两 个 步 又， 所 以 我 们 
可 以 把 这 两 个 步骤 用 作 各 个 测试 用 例 的 夹具 。 








代码 清单 8-21 展 示 了 使 用 夹具 之 后 的 server_test.go 。 





























代码 清单 8-21 使 用 测试 夹具 实现 的 测试 程序 




















package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 
"strings" 
"gopkg.in/check.v1" 


type PostTestSuite struct { e 
mux *http.ServeMux 
post *FakePost 
writer *httptest.ResponseRecorder 


} 


func init() { 
Suite(&PostTestSuite{}) 


} 


func Test(t *testing.T) { TestingT(t) } 


func (s *PostTestSuite) SetUpTest(c *C) ( e 
s.post - &FakePost() 
s.mux = http.NewServeMux() 
s.mux.HandleFunc("/post/", handleRequest(s.post)) 
s.writer - httptest.NewRecorder() 


} 


func (s *PostTestSuite) TestGetPost(c *C) ( 
request, _ := http.NewRequest("GET", "/post/1", nil) 
s.mux.ServeHTTP(s.writer, request) 


c.Check(s.writer.Code, Equals, 200) 

var post Post 
json.Unmarshal(s.writer.Body.Bytes(), &post) 
c.Check(post.Id, Equals, 1) 


} 


func (s *PostTestSuite) TestPutPost(c *C) ( 


json := strings.NewReader(^í("content":"Updated post"," 
Sheong"} ) 
request, _ := http.NewRequest("PUT", "/post/1", json) 


s.mux.ServeHTTP(s.writer, request) 


c.Check(s.writer.Code, Equals, 200) 
c.Check(s.post.Id, Equals, 1) 


author": 





Sau 


c.Check(s.post.Content, Equals, "Updated post") 
} 


O 存储 在 测试 套件 中 的 测试 夹具 数据 
e 创建 测试 夹具 


为 了 使 用 测试 夹具 ， 程 序 必须 将 它 的 数据 存储 在 某 个 地 方 ， 并 让 这 
些 数据 在 测试 过 程 中 一 直 存 在 。 为 此 ， 程 序 需要 给 测试 套件 结构 
PostTestSuite 添加 一 些 字段 ， 并 把 想 要 存储 的 测试 夹具 数据 记录 到 
这 些 字段 里 面 。 因 为 测试 套件 中 的 每 个 测试 用 例 实际 上 都 
是 PostTestSsuite 结构 的 一 个 方法 ， 所 以 这 些 测 试用 例 将 能 够 非常 方 
便 地 访问 到 结构 中 存储 的 夹具 数据 。 在 存储 好 夹具 数据 之 后 ， 程 序 会 使 
用 SetUpTest Pi se^ ER I L3 B. 











在 创建 夹具 的 过 程 中 ， 程 序 使 用 了 存储 在 PostTestSuite 结构 中 
的 字段 。 在 设置 好 夹具 之 后 ， 我 们 就 可 以 对 测试 程序 做 相应 的 修改 了 : 
需要 修改 的 地 方 并 不 多 ， 最 主要 的 工作 是 移 除 测试 用 例 中 重复 出 现 的 语 
句 ， 并 将 测试 用 例 中 使 用 的 结构 修改 为 测试 夹具 中 设置 的 结构 。 在 完成 
修改 之 后 再 次 执行 go test 命令 ， 我 们 将 得 到 以 下 结果 : 














START: server test.go:31: PostTestSuite.TestGetPost 
START: server test.go:24: PostTestSuite.SetUpTest 
PASS: server test.go:24: PostTestSuite.SetUpTest 0.000s 


PASS: server test.go:31: PostTestSuite.TestGetPost 0.000s 
START: server test.go:41: PostTestSuite.TestPutPost 
START: server test.go:24: PostTestSuite.SetUpTest 

PASS: server test.go:24: PostTestSuite.SetUpTest 0.000s 


PASS: server test.go:41: PostTestSuite.TestPutPost 0.000s 


OK: 2 passed 
PASS 
OK gocheck 0.007s 





特别 详细 标志 让 我 们 清晰 地 看 到 了 整个 测试 套件 的 运行 过 程 。 为 了 
进一步 观察 整个 测试 套件 的 运行 顺序 ， 我 们 可 以 把 以 下 测试 夹具 函数 添 
加 到 测试 程序 里 面 : 


func (s *PostTestSuite) TearDownTest(c *C) { 
c.Log("Finished test - ", c.TestName()) 

} 

func (s *PostTestSuite) SetUpSuite(c *C) { 
c.Log("Starting Post Test Suite") 

} 

func (s *PostTestSuite) TearDownSuite(c *C) { 
c.Log("Finishing Post Test Suite") 


} 





再 次 运行 测试 将 得 到 以 下 结 采 : 





START: server test.go:35: PostTestSuite.SetUpSuite 
Starting Post Test Suite 
PASS: server test.go:35: PostTestSuite.SetUpSuite 0.000s 


START: server test.go:44: PostTestSuite.TestGetPost 
START: server test.go:24: PostTestSuite.SetUpTest 
PASS: server test.go:24: PostTestSuite.SetUpTest 0.000s 


START: server test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestGetPost 
PASS: server test.go:31: PostTestSuite.TearDownTest 0.000s 


PASS: server test.go:44: PostTestSuite.TestGetPost 6.666s 
START: server test.go:54: PostTestSuite.TestPutPost 

START: server test.go:24: PostTestSuite.SetUpTest 

PASS: server test.go:24: PostTestSuite.SetUpTest 0.000s 


START: server test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestPutPost 


PASS: server test.go:31: PostTestSuite.TearDownTest 6.666s 
PASS: server test.go:54: PostTestSuite.TestPutPost 0.000s 
START: server test.go:39: PostTestSuite.TearDownSuite 


Finishing Post Test Suite 
PASS: server test.go:39: PostTestSuite.TearDownSuite 0.000s 


OK: 2 passed 
PASS 
ok gocheck 0.007s 





根据 测试 结果 显示 ，SetUpSuite 和 TearDownSuite 就 如 我 们 之 前 
介绍 的 一 样 ， 只 会 在 测试 开始 之 前 和 测试 结束 之 后 各 运行 一 次 ， 
而 SetUpTest 和 TearDownTest 则 会 作为 每 个 测试 用 例 的 第 一 行 语句 和 
最 后 一 行 语句 ， 在 测试 用 例 的 开头 和 结尾 分 别 运行 一 次 。 


作为 testing 包 的 增强 版 本 ， 简 单 而 强大 的 Gocheck 为 我 们 的 测 
试 “军火 库 ” 加 上 了 一 件 强 有 力 的 武器 ， 如 果 你 想 要 获得 比 Gocheck 更 强 
大 的 功能 ， 可 以 试 一 试 下 一 节 介 绍 的 Ginkgo 测 试 框架 。 





8.5.2 Ginkgo 测试 框架 简介 


Ginkgo 是 一 个 行为 驱动 开发 Cbehavior-driven development, BDD) 
风格 的 Go 测试 框架 。BDD 是 一 个 非常 庞大 的 主题 ， 想 要 在 小 小 的 一 节 
篇 幅 里 对 它 进行 完整 的 介绍 是 不 可 能 的 。 一 言 以 英之 ，BDD 是 测试 驱动 
开发 (test-driven development, TDD) 的 一 种 延伸 ， 但 BDD 跟 TDD 的 不 
同 之 处 在 于 ，BDD 是 一 种 软件 开发 方法 而 不 是 一 种 软件 测试 方法 。 在 
BDD 中 ， 软 件 由 它 的 目标 行为 进行 定义 ， 这 些 目标 行为 通常 是 一 系列 业 
务 需 求 。BDD 的 需求 是 从 行为 的 角度 ， 通 过 终端 用 户 的 语言 以 及 视角 来 
定义 的 ， 这 些 需求 在 BDD 中 称 为 用 户 故 事 (user story) 。 下 面 是 通过 


用 户 故 事 对 简单 Web 服 务 进行 描述 的 一 个 例子 。 





获取 一 张 帖 子 
为 了 





























向 用 户 显 示 指 定 的 一 张 
作为 


一 个 被 调用 的 程序 


























j 户 指定 的 帖子 























` 的 帖子 ID 
只 要 





一 个 带 有 该 ID 的 GET 请 求 








我 就 会 获得 与 给 定 ID 相 对 应 的 一 张 帖子 














j 一 个 非 整数 ID 








一 个 值 为 `"hello" 


-的 量子 ID 
Li zu 





一 个 带 有 该 ID 的 GET 请 求 











我 就 会 获得 一 个 HTTP 566 响 应 


在 定义 了 用 户 故 事 之 后 ， 我 们 就 可 以 把 这 些 用 户 故事 转换 为 测试 用 
例 。BDD 中 的 测试 用 例 跟 TDD 中 的 测试 用 例 一 样 ， 都 是 在 编写 实际 的 代 
码 之 前 编写 的 ， 这 些 测试 用 例 的 目标 在 于 开发 出 一 个 程序 ， 让 它 能 够 执 
行 用 户 故 事 中 描述 的 行为 。 坦 白地 说 ， 上 面 展 示 的 用 户 故 事 带 有 很 明显 
的 虚构 成 分 。 在 更 现实 的 环境 中 ，BDD 用 户 故 事 最 开始 通常 都 是 使 用 更 
高 层次 的 语言 来 撰写 ， 然 后 根据 细节 进行 数 次 层级 划分 之 后 ， 再 分 解 为 
更 为 具体 的 用 户 故 事 ， 最 终 ， 使 用 高 层次 语言 撰写 的 用 户 故 事 将 会 被 映 
财 到 一 系列 按 层级 划分 的 测试 套件 。 





Ginkgo 是 一 个 拥有 丰富 功能 的 BDD 风 格 的 框架 ， 它 提供 了 将 用 户 故 
事 映 射 为 测试 用 例 的 工具 ， 并 且 这 些 工 具 也 很 好 地 集成 到 了 Go 的 
testing 包 当 中 。 昌 然 Ginkgo 的 主要 用 于 在 Go 中 实现 BDD， 但 是 本 市 
只 会 把 Ginkgo 当 作 一 个 Go 的 测试 框架 来 使 用 。 


为 了 安装 Ginkgo， 我 们 需要 在 终 闪 中 执行 以 下 两 条 命令 : 


go get github.com/onsi/ginkgo/ginkgo 
go get github.com/onsi/gomega 


第 一 条 命令 下 载 Ginkgo 并 将 命令 行 接 口 程序 ginkgo 安装 
到 $GOPATH/bin 目录 中 ， 而 第 二 条 命令 则 会 下 载 Ginkgo 默 认 的 匹配 器 
库 Gomega [匹配 右 可 以 对 比 两 个 不 同 的 组 件 ， 这 些 组 件 可 以 是 结构 、 
映射 、 字 符 串 等 ) 。 


在 开始 学 习 如 何 使 用 Ginkgo 编 写 测试 用 例 之 前 ， 让 我 们 先 来 看 看 如 
何 使 用 Ginkgo 去 执行 已 有 的 测试 用 例 一 一 Ginkgo 能 够 自动 地 对 前 面 展示 
过 的 testing 包 测 试用 例 进行 语法 重 写 ， 把 它们 转换 为 Ginkgo 测 试用 








例 。 


为 了 验证 这 一 点 ， 我 们 将 会 使 用 上 一 节 展 示 过 的 带 有 依赖 注入 特性 
的 测试 套件 为 起 点 。 如 果 你 想 要 保留 原 有 的 测试 套件 ， 让 它们 免 受 
Ginkgo 的 修改 ， 那 么 请 在 执行 后 续 操作 之 前 先 对 其 进行 备份 。 在 一 切 准 
备 就 绪 之 后 ， 在 终端 里 面 执行 以 下 命令 : 


ginkgo convert . 


这 条 命令 会 在 目录 中 添加 一 个 名 为 xxx suite test.go 的 文件 ， 其 中 
xxx 为 目录 的 名 字 。 这 个 文件 的 具体 内 容 如 代码 清单 8-22 所 示 。 











代码 清单 8-22 Ginkgo 测试 套件 文件 








package main test 


import ( 
"github.com/onsi/ginkgo" 
"github.com/onsi/gomega" 


"testing" 
) 


func TestGinkgo(t *testing.T) ( 
RegisterFailHandler(Fail) 
RunSpecs(t, "Ginkgo Suite") 

j 





除 此 之 外 ， 上 述 命令 还 会 对 server_test. go 文件 进行 修改 ， 代 码 
清单 8-23 中 以 粗 体 的 形式 展示 了 文件 中 被 修改 的 代码 行 








代码 清单 8-23 ”修改 后 的 测试 文件 


package main 





import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"strings" 
. "github.com/onsi/ginkgo" 


) 


var _ = Describe("Testing with Ginkgo", func() ( 


It("get post", func() ( 


mux := http.NewServeMux() 

mux.HandleFunc("/post/", handleRequest(&FakePost1))) 
writer :- httptest.NewRecorder() 

request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 
GinkgoT().Errorf("Response code is Xv", writer.Code) 


j 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
GinkgoT().Errorf("Cannot retrieve JSON post") 


j 
}) 


It("put post", func() { 


mux := http.NewServeMux() 
post := &FakePost{} 
mux.HandleFunc("/post/", handleRequest(post)) 


writer :- httptest.NewRecorder() 


json := strings.NewReader('^í("content":"Updated post","author":"Sau 
Sheong"} ) 

request, _ := http.NewRequest("PUT", "/post/1", json) 

mux.ServeHTTP(writer, request) 


if writer.Code !- 200 ( 
GinkgoT().Error("Response code is Xv", writer.Code) 


} 


if post.Content != "Updated post" { 
GinkgoT().Error("Content is not correct", post.Content) 


}) 


}) 





注意 ， 修 改 后 的 测试 程序 并 没有 使 用 Gomega， 只 是 把 检查 执行 结 
果 的 语句 改 成 了 Ginkgo 提 供 的 Errorf 函数 和 Erro r 函 数 ， 不 过 这 两 个 
IZ testing 包 以 及 check 包 中 的 同名 函数 具有 相似 的 作用 。 当 我 们 
使 用 以 下 命令 运行 这 个 测试 程序 时 : 


Ginkgo 将 打印 出 一 段 格式 非常 漂亮 的 输出 : 





Running Suite: Ginkgo Suite 


Random Seed: 1431743149 
Will run 2 of 2 specs 
Testing with Ginkgo 

get post 

server test.go:29 


Testing with Ginkgo 
put post 
server test.go:48 
Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | © Failed | 0 Pending | © Skipped PASS 


Ginkgo ran 1 suite in 577.104764ms 
Test Suite Passed 





目 动 转换 己 有 的 测试 ， 然 后 漂亮 地 打印 出 它们 的 执行 结果 ， 这 给 人 
的 感觉 真 的 非常 不 错 ! 但 如 果 我 们 根本 没有 现成 的 测试 用 例 ， 是 否 需 要 
先 创建 出 testing 包 的 测试 用 例 ， 然 后 再 把 它们 转换 为 Ginkgo 测 试 呢 ? 
答案 是 人 否定 的 ! 没有 必要 多 此 一 举 ， 让 我 们 来 看 看 如 何 从 零 开 始 创建 
Ginkgo 测 试用 例 吧 。 





Ginkgo 提 供 了 一 些 实用 工具 ， 它 们 能 够 帮助 用 户 快速 、 方 便 地 创建 
测试 。 首 先 ， 清 空 与 上 一 次 测试 有 关 的 全 部 测试 文件 ， 包 括 之 前 Ginkgo 
创建 的 测试 套件 文件 ， 然 后 在 程序 的 目录 中 执行 以 下 两 条 命令 : 


ginkgo bootstrap 
ginkgo generate 


第 一 条 命令 会 创建 新 的 Ginkgo 测 试 套件 文件 ， 而 第 二 条 命令 则 会 为 
测试 用 例文 件 生 成 代码 清单 8-24 所 示 的 骨架 。 
































代码 清单 8-24 ” Ginkgo 测试 文件 





package main test 


import ( 
. "«path/to/your/go files»/ginkgo" 


"github.com/onsi/ginkgo" 
"github.com/onsi/gomega" 


var _ = Describe("Ginkgo", func() ( 





注意 ， 因 为 Ginkgo 会 把 测试 用 例 从 main 包 中 隔离 开 ， 所 以 新 创建 
的 测试 文件 将 不 再 属于 main 包 。 此 外 ， 测 试 程序 还 通过 点 导入 Cdot 
import) 语法 ， 将 几 个 库 中 包含 的 标识 符 全 部 导入 到 顶层 命名 空间 。 这 
种 导入 方式 并 不 是 必需 的 ，Ginkgo 在 它 的 文档 里 面 提 供 了 一 些 关 于 如 何 





避免 这 种 导入 的 说 明 ， 但 是 在 不 使 用 点 导入 语法 的 情况 下 ， 用 户 必 须 导 
出 main 包 中 需要 使 用 Ginkgo 测 试 的 所 有 函数 。 例 如 ， 因 为 我 们 接 下 来 
就 要 对 简单 Web 服 务 的 HandleRequest 函数 进行 测试 ， 所 以 这 个 函数 
一 定 要 被 导出 ， 也 就 是 说 ， 这 个 函数 的 名 字 的 首 字 母 必 须 大 写 。 





另外 需要 注意 的 是 ，Ginkgo 在 调用 Describe 函数 时 使 用 了 var 


这 一 技巧 。 这 种 常用 的 技巧 能 够 在 调用 Describe 函数 的 同时 ， 避 
免 引 入 init 函数 。 


代码 清早 8-25 展 示 了 使 用 Ginkgo 实 现 的 测试 用 例 代码 ， 这 些 代码 是 
由 早 前 撰写 的 用 户 故 事 映 射 而 来 的 。 





代码 清单 8-25 ”使 用 Gomega 匹 配器 实现 的 Ginkgo 测 试用 例 








package main test 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"github.com/onsi/ginkgo" 


"github.com/onsi/gomega" 
"gwp/Chapter 8 Testing Web Applications/test ginkgo' 


) 


var _ = Describe("Get a post", func() ( e 
var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost() 
mux - http.NewServeMux() 
mux.HandleFunc("/post/", HandleRequest(post)) 
writer - httptest.NewRecorder() 


J) 


Context("Get a post using an id", func() ( ee 
It("should get a post", func() { 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


Expect(writer.Code).To(Equal(200)) e 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 


Expect(post.Id).To(Equal(1)) 
}) 
}) 


Context("Get an error if post id is not an integer", func() ( e 
It("should get a HTTP 500 response", func() ( 
request, _ := http.NewRequest("GET", "/post/hello", nil) 
mux.ServeHTTP(writer, request) 


Expect(writer.Code).To(Equal(500)) 
}) 
}) 
}) 





e 用 户 故 事 


© 使 用 Gomega 匹 配器 


e 情景 1 
© 使 用 Gomega 对 正确 性 进行 断言 
Q9 情景 2 


注意 ， 这 个 测试 程序 使 用 了 来 目 Gomega 包 的 匹配 器 : Gomega 是 由 
Ginkgo 开 发 者 开发 的 一 个 断言 包 ， 包 中 的 匹配 器 都 是 测试 断言 。 
用 check 包 时 一 样 ， 测 试 程序 在 调用 Context 函数 模拟 指定 的 情景 之 
前 ， 会 完 设 置 好 相应 的 测试 夹具 : 


var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost() 
mux = http.NewServeMux() 
mux.HandleFunc("/post/", HandleRequest(post)) e 
writer - httptest.NewRecorder() 

}) 





Q x main 包 中 导出 的 函数 进行 测试 


注意 ， 为 了 从 main 包 中 导出 被 测试 的 处 理 器 ， 我 们 将 处 理 器 的 名 
字 从 原来 的 handleRequest 修改 成 了 首 字母 大 与 的 HandleRequest 。 
除 使 用 的 是 Gomega 的 断言 之 外 ， 程 序 中 展现 的 测试 场景 跟 我 们 之 前 使 
用 其 他 包 进 行 测试 时 的 场景 非常 类 似 。 下 面 是 一 个 使 用 Gomega 创 建 的 
Ir zi: 


Expect(post.Id).To(Equal(1)) 


在 这 个 断言 中 ，post.Id 是 要 测试 的 对 象 ，Equal 函数 是 匹配 器 ， 
而 1 是 预期 的 结果 。 针 对 我 们 写 的 测试 情景 ， 执 行 ginkgo 命令 将 返回 
以 下 结果 : 


Running Suite: Post CRUD Suite 


Random Seed: 1431753578 
Will run 2 of 2 specs 


Get a post using an id 
should get a post 
test ginkgo test.go:35 


Get a post using a non-integer id 
should get aHTTP500 response 
test ginkgo test.go:44 


Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | © Failed | © Pending | ð Skipped PASS 


Ginkgo ran 1 suite in 648.619232ms 
Test Suite Passed 








好 的 ， 关 于 使 用 Go 对 程序 进行 测试 的 介绍 到 这 里 就 结束 了 ， 在 接 
下 来 的 一 章 中 ， 我 们 将 会 讨论 如 何在 web 应 用 中 使 用 Go 的 一 个 关键 长 处 
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。 Go 通过 go test 命令 为 用 户 提供 了 内 置 的 测试 工具 ， 并 提供 了 
testing 包 以 便 实现 单元 测试 。 

e testing 包 提 供 了 基本 的 功能 测试 以 及 基准 测试 能 力 。 

e 对 于 Go 语言 来 说 ，Web 应 用 的 单元 测试 可 以 通过 


testing/httptest 包 来 完成 。 

e. 使 用 测试 蔡 身 可 以 让 测试 用 例 变 得 更 加 独立 。 

。 实现 测试 蔡 身 的 一 种 方法 是 使 用 依赖 注入 设计 模式 。 

e Go 语言 拥有 许多 第 三 方 测试 库 ， 其 中 包括 对 Go 的 测试 功能 进行 扩 
展 的 Gocheck 包 ， 以 及 实现 了 行为 驱动 测试 的 Ginkgo 包 。 











PIE ”发 挥 Go 的 并 发 优势 


本 章 主要 内 容 


。 从 原理 上 理解 并 发 和 并 行 
。 学 习 如 何 使 用 goroutine 以 及 通道 
。 在 Web 应 用 中 使 用 并 发 特性 








Go 语言 一 个 广为人知 的 特点 就 是 ， 可 以 更 容易 地 写 出 错误 更 少 的 
并 发 程序 。 本 章 将 介绍 并 发 这 一 技术 ， 并 讨论 Go 语言 的 并 发 模型 以 及 
设计 。 除 此 之 外 ， 我 们 还 会 深入 地 了 解 Go 语言 为 实现 并 发 而 提供 的 两 
个 特性 ， 它 们 分 别 是 goroutine 以 及 通道 。 在 本 章 的 最 后 ， 我 们 还 会 看 到 
一 个 使 用 Go 并 发 提高 Web 应 用 性 能 的 例子 。 





9.1 并 及 与 并 行 的 区 别 


并 发 〈concurrency) 指 的 是 两 个 或 多 个 任务 在 同一 时 间 段 内 局 动 、 
运行 并 结束 ， 并 且 这 些 任务 可 能 会 互动 。 以 并 发 形式 执行 的 多 个 任务 会 
同时 存在 ， 这 跟 顺 序 执行 每 次 只 会 存在 一 个 任务 的 情况 正好 相反 。 并 发 
是 一 个 非常 庞大 有 旦 复杂 的 主题 ， 本 章 将 会 简单 介绍 这 一 主题 。 





并 行 与 并 发 是 两 个 看 上 去 相似 但 实际 上 却 截 然 不 同 的 概念 ， 因 为 并 
发 和 并 行 都 可 以 同时 运行 多 个 任务 ， 所 以 很 多 人 都 把 这 两 个 概念 混 消 
了 。 对 于 并 发 来 说 ， 多 个 任务 并 不 需要 同时 开始 或 者 同时 结束 一 一 这 些 
任务 的 执行 过 程 在 时 间 上 是 相互 重 登 的 。 并 发 执行 的 多 个 任务 会 被 调 





度 ， 并 且 它 们 会 通过 通信 分 至 数据 并 协调 执行 时 间 (不 过 这 种 通信 并 不 
是 必须 的 〉。 


在 并 行 (parallelism) 中 ， 多 个 任务 将 同时 局 动 并 执行 。 并 行 通常 
ELA a 然后 通过 同时 执行 这 些小 任务 
来 提高 性 能 。 并 行 通 常 需要 独立 的 资源 〈 如 CPU) ， 而 并 发 则 会 使 用 和 
A wi Ro OM RESINA 
在 直觉 上 会 更 易 懂 一 些 。 并 行 ， 正 如 它 的 名 字 所 昭示 的 那样 ， 是 一 系列 
相互 平行 、 不 会 重 闭 的 处 理 过 程 。 





并 发 指 的 是 同时 处 理 多 项 任务 ， 而 并 行 指 的 是 同时 执行 多 项 任务 。 














— Rob Pike，Go 语 言 的 作者 之 一 





理解 并 发 的 男 一 种 方法 是 把 它 看 作 超 市 里 的 两 条 结账 通道 ， 但 这 两 
条 通道 上 的 顾客 需要 在 一 个 收银 台 排 队 等 候 ， 并 轮流 使 用 这 个 收银 台 结 
账 ， 如 图 9-1 所 示 。 





图 9-1 并 发 一 一 两 条 结账 通道 ， 但 是 只 有 一 个 收银 台 


男 一 方面 ， 并 行 同样 拥有 两 条 结账 通道 ， 只 是 每 条 通道 都 有 一 个 对 
应 的 收银 台 为 顾客 服务 ， 如 图 9-2 所 示 。 





图 9-2 ”并行 一 一 两 条 结账 通道 ， 每 条 都 对 应 一 个 收银 台 


位 管 并 及 和 并 行 在 概念 上 并 不 相同 ， 但 它们 并 不 相互 排斥 ， 比 如 


Go 语言 就 可 以 创建 出 同时 具有 并 发 和 并 行 这 两 种 特征 的 程序 。 为 了 让 
并 行程 序 可 以 同时 运行 多 个 任务 ，Go 语 言 的 用 户 需 要 将 环境 变量 
GOMAXPROCS 的 值 设置 成 大 于 1 。 在 Go 1.5 版 本 之 前 ，GOMAXPROCS 默认 
会 被 设置 为 1 ， 但 是 从 Go 1.5 版 本 开始 ，GOMAXPROCS 默认 将 被 设置 为 
系统 可 用 的 CPU 数 量 。 但 是 ， 并 发 程序 可 以 在 单个 CPU 上 运行 ， 至 于 程 
序 包 含 的 多 个 任务 则 会 通过 调度 独立 地 运行 ， 本 章 稍 后 就 会 出 现 一 个 这 
样 的 例子 。 需 要 注意 的 是 ， 尽 管 Go 语言 可 以 用 于 创建 并 行程 序 ， 但 这 
门 语言 在 设计 时 考虑 的 更 多 是 并 发 而 不 是 并 行 。 

















Go 语言 通过 goroutine 和 通道 这 两 个 主要 组 件 来 为 并 发 提供 文 持 ， 在 
接 下 来 几 节 中 ， 我 们 将 会 看 到 使 用 goroutine、 通 道 以 及 一 些 标准 库 来 构 
建 并 发 程序 的 具体 方法 。 





9.2 goroutine 


goroutine 指 的 是 那些 独立 于 其 他 goroutine 运 行 的 函数 。 这 一 概念 初 
看 上 去 和 线程 有 些 相 似 ， 但 实际 上 goroutine 并 不 是 线程 ， 它 只 是 对 线程 
的 多 路 复 用 。 因 为 goroutine 都 是 轻 量 级 的 ， 所 以 goroutine 的 数量 可 以 比 
线程 的 数量 多 很 多 。 一 个 goroutine 在 启动 时 只 需要 一 个 非常 小 的 栈 ， 并 
且 这 个 栈 可 以 按 需 扩展 和 缩小 〈 在 Go 1.4 中 ，goroutine 启 动 时 的 栈 大 小 
仅 为 2KB Ul) 。 当 一 个 goroutine 被 阻塞 时 ， 它 也 会 阻塞 所 复 用 的 操作 
系统 线程 ， 而 运行 时 环境 (runtime) 则 会 把 位 于 被 阻塞 线程 上 的 其 他 
goroutine 移 动 到 其 他 未 阻 罕 的 线程 上 继续 运行 。 





9.2.1 使 用 goroutine 


goroutine 的 用 法 非常 简单 : 只 要 把 go 关键 字 添 加 到 任意 一 个 具名 函 
数 或 者 匿名 函数 的 前 面 ， 该 函数 就 会 成 为 一 个 goroutine。 作 为 例子 ， 代 
码 清单 9-1 展 示 了 如 何在 名 为 goroutine. go 的 文件 中 创建 goroutine。 











代码 清单 9-1 ”goroutine 使 用 示例 








package main 


func printNumbers1() { 
for i := 0; i < 10; i++ { 
fmt.Printf("%d ", i) 
} 
} 


func printLetters1() { 
for i := 'A'; i < 'A'410; i++ { 
fmt.Printf("%c ", i) 
j 
} 


func print1() { 
printNumbers1() 
printLetters1() 
} 


func goPrint1() { 
go printNumbers1() 
go printLetters1() 
} 


func main() { 





goroutine.go 文 件 中 定义 了 printNumbers1 和 printLetters1 
两 个 函数 ， 分 别 用 于 循环 并 打印 数字 和 英文 字母 ， 其 中 printNumbers1 
会 打印 从 8 到 9 的 所 有 数字 ， 而 printLetters1 则 会 打印 从 A 到 ] 的 所 
有 英文 字母 。 除 此 之 外 ，goroutine. go 文件 中 还 定义 了 print1 和 
goPrint1 两 个 函数 ， 前 者 会 依次 调用 printNumbers1l 和 


printLetters1 ， 而 后 者 则 会 以 goroutine 的 形式 调用 printNumbers1 
和 printLetters1l 。 





为 了 检测 这 个 程序 的 运行 时 间 ， 我 们 将 通过 测试 而 不 是 main 函数 
来 运行 程序 中 的 print1 函数 和 goPrint1 函数 。 这 样 一 来 ， 我 们 就 不 必 
为 了 测量 这 两 个 函数 的 运行 时 间 而 编写 测量 代码 ， 这 也 避免 了 因为 编写 
计时 代码 而 导致 测量 不 准确 的 问题 。 











代码 清单 9-2 展 示 了 测试 用 例 的 具体 代码 ， 这 些 代码 单独 记录 在 了 
goroutine test.go 文 件 当中 。 

















代码 清 





9-2 ”运行 goroutine 示 例 的 测试 文件 








package main 
import "testing" 
func TestPrinti(t *testing.T) ( e 


print1() 
} 


func TestGoPrinti(t *testing.T) ( e 
goPrint1() 





O 测试 顺序 执行 的 函数 
四 测试 对 以 goroutine 形式 执行 的 函数 


过 使 用 以 下 命令 执行 这 一 测试 : 


我 们 将 得 到 以 下 结果 ; 


UN TestPrint1 


3456789ABCDEFGHI]J --- PASS: TestPrint1 (0.00s) 
UN TestGoPrint1 


ASS: TestGoPrint1 (0.00s) 





注意 ， 第 二 个 测试 用 例 并 没有 产生 任何 输出 ， 这 是 因为 该 用 例 在 它 
的 两 个 goroutine 能 够 产生 输出 之 前 就 已 经 结束 了 。 为 了 让 第 二 个 测试 用 
例 能 够 正常 地 产生 输出 ， 我 们 需要 使 用 time 包 中 的 Sleep 函数 ， 在 第 
二 个 测试 用 例 的 末尾 加 上 一 些 延迟 : 
func TestGoPrinti(t *testing.T) { 

goPrinti() 


time.Sleep(1 * time.Millisecond) 
} 








这 样 一 来 ， 第 二 个 测试 用 例 束 会 在 该 测试 用 例 结束 之 前 正常 地 产生 
输出 了 : 


789 ABCDEFGH I J --- PASS: TestPrint1 (0.00s) 
oPrint1 


789 ABCDEFGH IJ --- PASS: TestGoPrint1 (0.00s) 





这 两 个 测试 用 例 都 产生 了 相同 的 结果 。 初 看 上 去 ， 是 否 使 用 
goroutine 似 乎 并 没有 什么 不 同 ， 但 事实 上 ， 这 两 个 测试 用 例 之 所 以 会 产 
生 相 同 的 结果 ， 是 因为 printNumbers1 函数 和 printLetters1 函数 都 
运行 得 如 此 之 快 ， 所 以 是 否 以 goroutine 形 式 运行 它们 并 不 会 产生 任何 区 


别 。 为 了 更 准确 地 模拟 正常 的 计算 任务 ， 我 们 将 通过 time 包 中 的 Sleep 
函数 人 为 地 给 这 两 个 函数 加 上 一 点 延迟 ， 并 把 带 有 延迟 的 函数 重新 命名 
为 printNumbers2 和 printLetters2 。 代 码 清单 9-3 展 示 了 这 两 个 新 函 
数 ， 跟 原来 的 函数 一 样 ， 它 们 也 会 被 放 在 goroutine.go 文 件 中 。 
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9-3 ”模拟 执行 计算 任务 的 goroutine 











func printNumbers2() { 
for i := ð; i < 10; i++ { 
time.Sleep(1 * time.Microsecond @ 
fmt.Printf("%d ", i) e 
)e 
)e 


func printLetters2() ( e 
for i := 'A'; i < 'A'10; i++ ( e 
time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i)e 
} 
} 


func goPrint2() ( 
go printNumbers2() 
go printLetters2() 
} 





@ 添加 1 ps 的 延迟 ， 用 于 模拟 计算 任务 


新 定义 的 两 个 函数 通过 在 每 次 迭代 中 添加 1s 的 延迟 来 模拟 计算 任 
务 。 为 了 测试 新 添加 的 goPrint2 函数 ， 我 们 将 在 goroutine_test.go 
文件 中 添加 相应 的 测试 用 例 ， 并 且 和 之 前 一 样 ， 为 了 让 被 测试 的 函数 

能 够 正常 地 产生 输出 ， 测 试用 例 将 在 调用 goPrint2 函数 之 后 等 待 1hs: 





func TestGoPrint2(t *testing.T) ( 
goPrint2() 
time.Sleep(1 * time.Millisecond) 


现在 ， 运 行 测试 用 例 将 得 到 以 下 输出 : 


TestPrint1 

456789ABCDEFGHIJ --- PASS: TestPrint1 (0.00s) 
TestGoPrint1 

456789 ABCDEFGH IJ --- PASS: TestGoPrint1 (0.00s) 
TestGoPrint2 

CD2E3F4GH51673789 --- PASS: TestGoPrint2 (0.00s) 


c 


c 
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注意 看 TestGoPrint2 函数 的 输出 结果 ， 从 结果 可 以 看 出 ， 程 序 这 
次 并 不 是 先 执 行 printNumbers2 函数 ， 然 后 再 执行 printLetters2 iK 
数 ， 而 是 交 蔡 地 执行 它们 ! 


如 果 我 们 再 执行 一 次 这 个 测试 ， 那 么 TestGoPrint2 水 数 的 输出 结 
果 的 最 后 一 行 可 能 会 有 所 不 同 : 这 是 因为 printNumbers2 和 
printLetters2 都 是 独立 运行 的 ， 并 且 它 们 都 在 争先 恕 后 地 想 要 将 日 
己 的 结果 输出 到 屏 大 上 ， 所 以 随 着 这 两 个 函数 的 执行 顺序 不 同 ， 测 试 产 
"ERE pce 唯一 的 例外 是 ， 如 果 你 使 用 的 是 Go 1.5 之 前 的 
版 本 ， 那 么 你 每 次 执行 这 个 测试 都 会 得 到 相同 的 结果 。 








之 所 以 会 出 现 这 种 情况 ， 是 因为 Go 1.5 之 前 的 版 本 在 用 户 没 有 另行 
设置 的 情况 下 ， 即 使 计算 机 拥有 多 于 一 个 CPU， 它 默认 也 只 会 使 用 一 个 
CPU。 但 是 从 Go 1.5 开 始 ， 这 一 情况 发 生 了 改变 Go 运行 时 环境 会 使 
用 计算 机 拥有 的 全 部 CPU。 在 Go 1.5 或 以 后 的 版 本 中 ， 用 户 如 果 想 要 让 
Go 运行 时 环境 只 使 用 一 个 CPU， 就 需要 执行 以 下 命令 : 


go test -run x -bench . -cpu 1 
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在 执行 了 这 个 命令 之 后 ， 每 次 执行 TestGoPrint2 都 将 得 到 完全 相 
同 的 结果 。 


9.2.2 ”goroutine 与 性 能 


在 了 解 了 goroutine 的 运作 方式 之 后 ， 接 下 来 我 们 要 考虑 的 就 是 如 何 
通过 goroutine 来 提高 性 能 。 本 节 在 进行 性 能 测试 时 将 沿用 上 一 节 定 义 的 
print1 、goPrint1 等 国 数 ， 但 为 了 避免 这 些 冰 数 在 并 发 执行 时 输出 一 
些 乱糟糟 的 结果 ， 这 次 我 们 将 把 代码 中 的 fmt .Println 语句 注释 掉 。 
代码 清单 9-4 展 示 了 为 print1 函数 和 goPrint1 函数 设置 的 基准 测试 用 
例 ， 这 些 用 例 定义 在 goroutine_test.go 文 件 中 。 














代码 清单 9-4 ”为 无 goroutine 和 有 goroutine 的 函数 分 别 创建 基准 测试 用 例 











func BenchmarkPrint1(b *testing.B) ( e 
for i := 0; i < b.N; i++ { 
print1() 
} 
} 


func BenchmarkGoPrint1(b *testing.B) { e 
for i := 00; i < b.N; i++ { 
goPrint1() 
} 
} 








@ 对 顺序 执行 的 函数 进行 基准 测试 
© 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 


在 使 用 以 下 命令 进行 性 能 基准 测试 并 跳 过 功能 测试 之 后 : 





go test -run x -bench . -cpu 1 


我 们 将 看 到 以 下 结果 : 
BenchmarkPrint1 100000000 13.9 ns/op 
BenchmarkGoPrinti1 . 1000000 1090 ns/op 








(运行 这 个 测试 只 使 用 了 单个 CPU， 具 体 原因 本 章 稍 后 将 会 说 

到 。) 正如 结果 所 示 ， 函 数 print1l 运行 得 非常 快 ， 只 使 用 了 13.9 ns. 
令 人 感到 惊讶 的 是 ， 在 使 用 goroutine 运 行 相同 函数 时 ， 程 序 的 速度 居然 
慢 了 如 此 之 多 ， 足 足 耗 费 了 1090 ns! 出 现 这 种 情况 的 原因 在 于 “天 下 没 
有 免费 的 午餐 ”: 无 论 goroutine 有 多 么 的 轻 量 级 ， 局 动 goroutine 还 是 有 
一 定 的 代价 的 。 因 为 printNumbers1 函数 和 printLetters1 函数 是 如 
此 简单 ， 它 们 执行 的 速度 是 如 此 快 ， 所 以 以 goroutine 方 式 执 行 它们 反而 
会 比 顺序 执行 的 代价 更 大 。 





如 果 我 们 对 每 次 迭代 都 带 有 一 定 延 人 运 的 printNumbers2 函数 和 
printLetters2 疯 数 执行 类 似 的 测试 ， 结 果 叉 会 如 何 呢 ?代码 清单 9-5 
展示 了 goroutine_test .go 文件 中 为 以 上 两 个 函数 设置 的 基准 测试 用 
例 。 

















代码 清单 9-5 ”为 无 goroutine 和 有 goroutine 的 带 延 迟 函数 分 别 创建 基准 测试 用 例 

















func BenchmarkPrint2(b *testing.B) ( e 
for i := 6; i < b.N; i++ { 
print2() 
j 
} 


func BenchmarkGoPrint2(b *testing.B) { e 
for i:20; i < b.N; i++ { 


goPrint2() 





j 
j 
@ 对 顺序 执行 的 函数 进行 基准 测试 
€) 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 
在 运行 这 一 基准 测试 之 后 ， 我 们 将 得 到 以 下 结果 : 
BenchmarkPrint2 10000 121384 ns/op 
BenchmarkGoPrint2 1000000 17206 ns/op 


这 次 的 测试 结果 跟 上 一 次 的 测试 结果 有 些 不 同 。 可 以 看 到 ， 以 
goroutine 方 式 执行 print Numbers2 和 printLetters2 的 速度 是 以 顺序 
方式 执行 这 两 个 函数 的 速度 的 差不多 7 倍 。 现 在 ， 让 我 们 把 函数 的 迭代 
次 数 从 10 次 改 为 100 次 ， 然 后 再 运行 相同 的 基准 测试 : 





func printNumbers2() { 
for i := 0; i < 100; i++ { e 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%d ", i) 
} 
} 


func printLetters2() { 
for i := 'A'; i < 'A'+100; i++ ( e 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%c ", i) 
j 
} 





Q i100 次 而 不 是 10 次 


© 迭代 100 次 而 不 是 10 次 
下 面 是 这 次 基准 测试 的 结果 ; 


BenchmarkPrinti 20000000 86.7 ns/op 
BenchmarkGoPrinti1 1000000 1177 ns/op 


BenchmarkPrint2 2000 1184572 ns/op 
BenchmarkGoPrint2 1000000 17564 ns/op 





在 这 次 基准 测试 中 ，print1 函数 的 基准 测试 时 间 是 之 前 的 13 倍 ， 
而 goPrint1 函数 的 速度 跟 上 一 次 相 比 没有 出 现 太 大 变化 。 另 一 方面 ， 
通过 延迟 模拟 负载 的 函数 的 测试 结果 变化 非常 之 大 一 一 以 顺序 方式 执行 
的 函数 和 以 goroutine 方 式 执行 的 函数 之 间 ， 两 者 的 执行 时 间 相 差 了 67 倍 
之 多 。 因 为 这 次 基准 测试 的 迭代 次 数 比 之 前 增加 了 10 倍 ， 所 以 print2 
函数 在 进行 基准 测试 时 的 速度 差不多 是 上 次 的 /10， 但 对 于 goPrint2 
来 说 ， 和 迭代 10 次 所 需 的 时 间 跟 迭代 100 次 所 需 的 时 间 却 几乎 是 相同 的 。 








注意 ， 到 目前 为 止 ， 我们 部 是 在 用 一 个 CPU 执 行 测 试 ， 但 如 果 我 们 
执行 以 下 命令 ， 改 用 两 个 CPU 执 行 带 有 100 次 迭代 的 基准 测试 : 


go test -run x -bench . -cpu 2 


那么 我 们 将 得 到 以 下 结果 : 


BenchmarkPrinti-2 20000000 87.3 ns/op 
BenchmarkGoPrint2-2 5000000 391 ns/op 
BenchmarkPrint2-2 1000 1217151 ns/op 


BenchmarkGoPrint2-2 200000 8607 ns/op 








因为 print1 函数 以 顺序 方式 执行 ， 无 论 运 行 时 环境 提供 多 少 个 


CPU， 它 都 只 能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 跟 上 一 次 的 测试 
结果 基本 相同 。 与 此 相反 ，goPrint1 函数 这 次 因为 使 用 了 两 个 CPU 来 
分 担 计算 负载 ， 所 以 它 的 性 能 提高 了 将 近 3 倍 。 此 外 ， 因 为 print2 也 只 
能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 也 跟 预 料 中 的 一 样 ， 并 没有 发 
生 什 么 变化 。 最 后 ， 因 为 goPrint2 使 用 了 两 个 CPU 来 分 担 计算 负载 ， 
所 以 它 这 次 的 测试 比 之 前 快 了 两 倍 。 





现在 ， 如 果 我 们 更 进一步 ， 使 用 4 个 CPU 来 运行 相同 的 基准 测试 ， 
结果 将 会 如 何 ? 


BenchmarkPrint1-4 20000000 90.6 ns/op 
BenchmarkGoPrint1-4 3000000 479 ns/op 


BenchmarkPrint2-4 1000 1272672 ns/op 
BenchmarkGoPrint2-4 300000 6193 ns/op 





正如 我 们 预期 的 那样 ，print1 函数 和 print2 函数 的 测试 结果 还 是 
一 如 既往 地 没有 发 生 什 么 变化 。 但 令 人 惊奇 的 是 ， 尽 管 goPrint1 在 使 
用 4 个 CPU 时 的 测试 结果 还 是 比 只 使 用 一 个 CPU 时 的 测试 结果 要 好 ， 但 
使 用 4 个 CPU 的 执行 速度 居然 比 使 用 两 个 CPU 的 执行 速度 要 慢 。 与 此 同 
时 ， 虽 然 只 有 40% 的 提升 ， 但 goPrint2 在 使 用 4 个 CPU 时 的 成 绩 还 是 比 
使 用 2 个 CPU 时 的 成 绩 要 好 。 使 用 更 多 CPU 并 没有 市 来 性 能 提升 反而 导 
致 性 能 下 降 的 原因 跟 之 前 提 到 的 一 样 : 在 多 个 CPU 上 调度 和 运行 任务 需 
要 耗费 一 定 的 资源 ， 如 果 使 用 多 个 CPU 带 来 的 性 能 优势 不 足以 抵消 随 之 
而 来 的 额外 消耗 ， 那 么 程序 的 性 能 就 会 不 升 反 降 。 











升 ， 更 重要 的 是 要 理解 代码 ， 并 对 其 进行 基准 调试 ， 以 了 解 它 的 性 能 特 


质 。 
9.2.3 ”等 符 goroutine 


在 上 一 节 中 ， 我 们 了 解 到 程序 启动 的 goroutine 在 程序 结束 时 将 会 被 
粗 又 地 结束 ， 虽 然 通 过 Sleep 函数 来 增加 时 间 延 迟 可 以 避免 这 一 问题 ， 
但 这 说 到 底 只 是 一 种 权宜 之 计 ， 并 没有 真正 地 解决 问题 。 虽 然 在 实际 的 
代码 中 ， 程 序 本 身 比 goroutine 更 早 结束 的 情况 并 不 多 见 ， 但 为 了 避免 意 
外 ， 我 们 还 是 需要 有 一 种 机 制 ， 使 程序 可 以 在 确保 所 有 goroutine 都 已 经 
执行 完毕 的 情况 下 ， 再 执行 下 一 项 工作 。 








为 此 ，Go 语 言 在 sync 包 中 提供 了 一 种 名 为 等 待 组 (WaitGroup ) 
的 机 制 ， 它 的 运作 方式 非常 简单 直接 : 


。 声明 一 个 等 待 组 ; 

。 使 用 Add 方法 为 等 待 组 的 计数 器 设置 值 ; 

e 当 一 个 goroutine 完 成 它 的 工作 时 ， 使 用 Done 方法 对 等 待 组 的 计数 器 
执行 减 一 操作 ; 

。 调用 Wait 方法 ， 该 方法 将 一 直 阻 塞 ， 直 到 等 竺 组 计数 器 的 值 变 为 
0。 


代码 清单 9-6 展 示 了 一 个 使 用 等 待 组 的 例子 ， 在 这 个 例子 中 ， 我 们 
复 用 了 之 前 展示 过 的 printNumbers2 函数 以 及 printLetters2 函数 ， 
并 为 它们 分 别 加 上 了 1lhs 的 延迟 。 

















代码 清单 9-6 ”使 用 等 待 组 


package main 





import "fmt" 
import "time" 
import "sync" 


func printNumbers2(wg *sync.WaitGroup) { 
for i:20;i« 10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt.Printf("4d ", i) 
j 


wg.Done() e 


func printLetters2(wg *sync.WaitGroup) { 
for i := 'A'; i < 'A'410; i++ ( 
time.Sleep(1 * time.Microsecond) 
fmt.Printf("%c ", i) 
} 


wg.Done() @ 


func main() { 
var wg sync.WaitGroup @ 
wg.Add(2) e 
go printNumbers2(&wg) 
go printLetters2(&wg) 
wg.Wait() e 





@ 对 计数 器 执行 减 一 操作 


O 对 计数 器 执行 减 一 操作 
@ 声明 一 个 等 待 组 

@ 为 计数 器 设置 值 

© 阻塞 到 计数 器 的 值 为 


如 果 我 们 运行 这 个 程序 ， 那 么 它 将 巧妙 地 打印 出 A1B2C3 


D4E5F66G67H8I9]。 这 个 程序 的 运作 原理 是 这 样 的 : 它 首 
先 定 义 一 个 名 为 wg 的 WaitGroup 变量 ， 然 后 通过 调用 wg 的 Add 方法 将 
计数 器 的 值 设 置 成 2; 在 此 之 后 ， 程 序 会 分 别 调用 printNumbers2 和 

printLetters2 这 两 个 goroutine， 而 这 两 个 goroutine 都 会 在 末尾 对 计数 
器 的 值 执行 减 一 操作 。 之 后 程序 会 调用 等 待 组 的 Nait 方法 ， 并 因此 而 

被 阻塞 ， 这 一 状态 将 持续 到 两 个 goroutine 都 执行 完毕 并 调用 Done 方法 

为 止 。 当 程序 解除 阻塞 状态 之 后 ， 它 就 会 跟 平 常 一 样 ， 自 然 地 结束 。 


如 果 我 们 在 某 个 goroutine 里 面 忘记 了 对 计数 器 执行 减 一 操作 ， 那 么 
等 竺 组 将 一 直 阻 塞 ， 直 到 运行 时 环境 发 现 所 有 goroutine 都 已 经 休眠 为 
止 ， 这 时 程序 将 引发 一 个 panic: 











OA1LB2C3D4E5F667H8I9]Tfatal error: all goroutines are as 
leep - deadlock! 


TAX  REPEANDCISIER., MEH, CIHR RUE Doe — MU 
可 或 缺 的 工具 。 


在 前 一 节 ， 我 们 学 习 了 如 何 通过 go 关键 字 ， 把 普通 函数 转换 为 
goroutine 以 便 让 其 独立 运行 ， 并 在 9.2.2 节 学 习 了 如 何 通过 等 待 组 来 同步 
独立 运行 的 多 个 goroutine。 在 这 一 节 ， 我 们 将 要 学 习 的 是 ， 如 何 使 用 通 
道 在 多 个 不 同 的 goroutine 之 间 通 信 。 


通道 就 像 是 一 个 箱子 ， 不 同 的 goroutine 可 以 通过 这 个 箱子 与 其 他 
goroutine 通 信 : 如 果 一 个 goroutine 想 要 把 一 项 信息 传递 给 另 一 个 


goroutine， 那 么 它 就 必须 把 该 信息 放置 到 箱子 里 ， 然 后 男 一 个 goroutine 
则 负责 从 箱子 里 取出 被 放置 的 信息 ， 融 像 图 9-3 所 示 的 那样 。 















接收 者 


goroutine 


发 送 者 


goroutine 


Go 的 无 缓冲 通道 


图 9-3 ”把 Go 的 无 缓冲 通道 看 作 是 一 个 箱子 


通道 (channel) 是 一 种 带 有 类 型 的 值 (typed value) ， 它 可 以 让 不 
同 的 goroutine 互 相通 信 。 通 道 用 make 函数 创建 ， 该 函数 在 被 调用 之 后 
将 返回 一 个 指 同 底层 数据 结构 的 引用 作为 结果 值 。 比 如 ， 以 下 代码 就 展 
示 了 如 何 创建 一 个 由 整数 组 成 的 通道 





ch := make(chan int) 








make 函数 默认 创建 的 都 是 无 绥 冲 通道 (unbuffered channel) ， 如 果 
用 户 在 创建 通道 时 ， use 函数 提供 了 可 选 的 第 三 个 整数 参数 ， 那 
么 make 函数 将 创建 出 一 个 融 有 给 定 大 小 的 有 缓冲 通道 〈buffered 
channel) 。 比 如 说 ， IE E 





ch := make(chan int, 10) 


Mi 
v 


无 缓冲 通道 是 同步 的 ， 它 就 像 是 一 个 每 次 只 能 容纳 一 件 物体 的 箱 
d: 当 一 个 goroutine 把 一 项 信息 放 入 无 缓冲 通道 之 后 ， 除 非 有 某 个 
goroutine 把 这 项 信息 取 走 ， 否 则 其 他 goroutine 将 无 法 再 向 这 个 通道 放 入 
CURE: 这 也 意味 着 ， 如 果 一 个 goroutine 想 要 同一 个 已 经 包含 了 某 项 

忌 的 无 绥 冲 通道 再 放 入 一 项 信息 ， 那 么 这 个 goroutine 将 被 阻塞 并 进入 
KERS ， 直 到 该 通道 变 空 为 止 。 





同样 地 ， 如 果 一 个 goroutine 演 试 从 一 个 并 没有 包含 任何 信息 的 无 组 
冲 通 道中 取出 一 项 信息 ， 那 么 这 个 goroutine 将 会 被 阻塞 并 进入 休眠 状 
态 ， 直 到 通道 不 再 为 空 为 止 。 


将 信息 放 入 通道 EE 比如 ， 通 过 执行 以 下 语句 ， 
我 们 可 以 把 数字 1 放 入 通道 ch Hf: 


E E ER E EA 比如 ， 通 过 执行 以 下 语 
句 ， 我 们 可 以 从 通道 ch 里 面 移 除 一 个 值 ， 并 将 该 值 赋值 给 变量 i : 


通道 可 以 是 定 问 的 〈directional) 。 在 默认 E 道 将 以 双 同 
HJ CbidirectionaD 形式 运作 ， 用 户 既 可 以 把 值 放 入 通 po 以 从 通 











道 取 出 值 ， 但 是 ， 通 道 也 可 以 被 限制 为 只 能 执行 发 送 操作 (send-only) 
或 者 只 能 执行 接收 操作  Creceive-only) 。 比 如 ， 以 下 语句 就 展示 了 如 
何 创 建 一 个 只 能 执行 发 送 操作 的 字符 串通 道 : 


ch := make(chan «- string) 


而 以 下 语句 则 展示 了 如 何 创建 一 个 只 能 执行 接收 操作 的 字符 串通 道 


ch := make(<-chan string) 


用 户 除了 可 以 直接 创建 定 疝 的 通道 之 外 ， 还 可 以 把 一 个 双 癌 通道 转 
变 为 定 问 通道 ， 我 们 将 会 在 本 半 的 末尾 看 到 一 个 这 样 的 例子 。 








9.3.1 通过 通道 实现 同步 


也 许 你 已 经 猜 到 了 ， 通 道 非常 适用 于 对 两 个 goroutine 进 行 同步 ， 当 
一 个 goroutine 需 要 依赖 另 一 个 goroutine 时 ， 更 是 如 此 。 事 不 宜 迟 ， 让 我 
们 马上 来 看 看 代码 清单 9-7 所 示 的 程序 ， 这 个 程序 沿用 了 上 一 节 展 示 过 
的 例子 ， 唯 一 的 不 同 在 于 ， 这 次 的 程序 使 用 了 通道 而 不 是 等 竺 组 来 对 
goroutine 进 行 同步 。 




















代码 清单 9-7 使 用 通道 同步 goroutine 


























package main 


import "fmt" 
import "time" 


func printNumbers2(w chan bool) ( 
for i := 0; i < 10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt.Printf("%d ", i) 


)e 
func printLetters2(w chan bool) { e 
for i := 'A'; i < 'A'10; i++ (e 


time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i) e 


func main() { 
w1, w2 :- make(chan bool), make(chan bool) 
go printNumbers2(w1) 
go printLetters2(w2) 
«-w1 e 
«-w2 06 


} 





@ 把 一 个 布尔 值 放 入 通道 ， 以 便 解 除 主 程序 的 阻 竖 状态 
O 主 程序 将 一 直 阻 塞 ， 直 到 通道 里 面 出 现 可 弹出 的 值 为 止 


先 来 看 看 这 iM 函数 。 它 自 先 创建 了 wl 和 w2 这 两 
个 bool 类 型 的 通道 ， 接 着 以 goroutine 方 式 运行 了 printNumbers2 函数 
A 函数 ， "VUE UE Me PUR 数 。 在 局 
T Ene us main 函数 将 会 尝试 从 通道 w1 中 移 除 一 个 值 ， 但 
由 于 通道 w1 当时 并 没有 包含 任何 值 ， 所 以 main 函数 将 会 在 此 处 阻 窄 。 
当 printNumbers2 即将 执行 完毕 ， 并 将 一 个 true 值 放 入 通道 wl1 之 
JH, main 函数 的 阻 罕 状态 才 会 说 解除 ， 并 继续 尝试 从 第 二 个 通道 w2 中 
弹出 一 个 值 。 跟 之 前 一 样 ， 在 printLetters2 W4 22 IM 
入 通道 w2 Z. Bj, main 函数 将 一 直 阻 塞 ， 直 到 它 成 功 取得 了 w2 通道 中 的 
true 值 之 后 ， 阻 窜 才 会 解除 ， 然 后 main 函数 才 会 顺利 退出 。 





需要 注意 的 是 ， 因 为 我 们 只 是 想 要 在 goroutine 执 行 完毕 之 后 解除 对 
main 函数 的 阻塞 ， 而 不 是 真正 地 想 要 使 用 通道 中 存储 的 值 ， 所 以 程序 
在 从 通道 wl 和 w2 里 面 取出 值 之 后 并 没有 使 用 这 些 值 。 








代码 清单 9-7 展 示 的 是 一 个 非常 简单 的 例子 ， 这 个 例子 中 的 程序 使 
用 通道 只 是 为 了 对 多 个 goroutine 进 行 同 步 ， 但 这 些 goroutine 之 间 并 没有 
通信 。 不 过 在 接 下 来 的 一 节 ， 我 们 就 会 看 到 一 个 在 多 个 goroutine 之 间 传 
递 消息 的 例子 。 








9.3.2 ”通过 通道 实现 消息 传递 


代码 清单 9-8 展 示 了 两 个 以 goroutine 形 式 独立 运行 的 函数 ， 其 中 一 个 
Rreiz (thrower) ， 它 接受 一 个 通道 作为 参数 ， 然 后 一 个 接 一 个 
地 把 一 Rin NEM 而 另 一 个 函数 则 是 捕捉 器 〈catcher) ， 它 
会 从 相同 的 通道 里 一 个 接 一 个 地 取出 一 组 数字 ， 并 把 这 些 数字 打印 出 
X. 




















代码 清单 9-8 ”使 用 通道 实现 消息 传递 





package main 


import ( 
"n fmt " 
"time" 


) 


func thrower(c chan int) { 
for i := 0; i < 5; i++ { 
c«-ie 
fmt.Println("Threw »»", i) 
} 
} 


func catcher(c chan int) { 
for i:20;i« 5; i++ { 


num :- «-c e 
fmt.Println("Caught ««", num) 


} 


func main() { 

C := make(chan int) 

go thrower(c) 

go catcher(c) 

time.Sleep(100 * time.Millisecond) 
j 





@ 把 数字 值 推 入 通道 中 
e 从 通道 中 取出 数字 值 


运行 这 个 程序 将 得 到 以 下 结果 : 


上 ww 上 OO 





在 这 上 段 输 出 结果 中 ， 某 些 Caught 语句 出 现在 了 Threw 语句 的 前 








面 ， 但 这 并 不 意味 着 程序 的 运行 出 现 了 错误 一 一 之 所 以 会 出 现 这 样 的 乱 
象 ， 仪 仅 是 因为 运行 时 环境 在 向 通道 推 入 值 或 者 从 通道 中 取出 值 之 后 ， 
调度 到 了 打印 语句 所 人 至。 最 重要 的 是 ， 打 印 语句 中 出 现 的 数字 都 是 有 序 
的 ， 这 意味 着 投 撕 器 在 同 通 道 “ 投 撕 ” 一 个 数字 之 后 ， 捕 提 费 必须 先 “ 捕 
捉 ” 这 个 数字 ， 然 后 才能 处 理 下 一 个 数字 。 








9.3.3 “有 缓冲 通道 


无 缓冲 通道 或 者 说 同步 通道 (synchronous channel) 使 用 起 来 非常 
简单 ， 而 与 之 相对 的 有 缓冲 通道 则 更 复杂 一 些 ， 后 者 是 一 种 异步 的 、 先 
进 先 出 消息 队列 。 如 图 9-4 所 示 ， 有 缓冲 通道 就 像 是 一 个 能 够 容纳 多 个 
同类 信息 的 大 箱子 : 一 个 goroutine 可 以 持续 地 向 箱子 里 面 推 入 信息 ， 并 
且 在 箱子 被 填 满 之 前 ， 推 入 信息 的 goroutine 都 不 会 被 阻塞 ， 同 样 地 ， 一 
个 goroutine 可 以 按照 信息 被 推 入 的 顺序 ， 持 续 地 从 箱子 里 取出 信息 ， 并 


且 在 箱子 被 掏 空 之 前 ， 取 出 信息 的 goroutine 都 不 会 被 阻塞 。 
接收 者 
goroutine 


发 送 者 
goroutine 





Hid 
iH 












Go 的 有 缓冲 通道 


图 9-4 将 Go 的 有 缓冲 通道 看 作 是 一 个 箱子 


接 下 来 ， 就 让 我 们 看 看 有 缓冲 通道 在 投掷 器 和 捕捉 器 的 例子 中 是 如 
人 为 此 ， 我 们 需要 对 代码 清单 9-8 中 ， 以 下 这 个 创建 无 缓冲 通 
道 的 语句 进行 修改 : 


C := make(chan int) 


证 它 转 而 创建 一 个 大 小 为 3 的 有 缓冲 通道 : 


C := make(chan int, 3) 





[L SE 
运行 修改 后 的 程序 ， 我 们 将 得 到 以 下 结果 : 


Threw >> 0 
Threw >> 1 
Threw >> 2 
Caught << 6 
Caught << 1 


Caught << 2 
Threw >> 3 
Threw >> 4 
Caught << 3 
Caught << 4 





My dien RRIEUEEJ. HRR AEEA, EDBDEDXEqeE 
HWI RIENE, mA PEA AU s RIT PARLE E H E BETTE IZ 
字 。 如 采 你 在 解决 东 个 问题 的 时 候 ， 只 有 有 限 数量 的 工作 进程 可 用 ， 并 
且 你 打算 限制 传 入 请 求 的 数量 ， 那 么 有 缓冲 通道 将 是 一 种 非常 合适 的 工 
具 


9.3.4 从 多 个 通道 中 选择 

Go 拥有 一 个 特殊 的 关键 字 select ， 它 允许 用 户 从 多 个 通道 中 选择 
一 个 通道 来 执行 接收 或 者 发 送 操作 。select 关键 字 就 像 是 专门 为 通道 
而 设 的 switch 语句 ， 代 码 清单 9-9 展 示 了 一 个 使 用 select 关键 字 的 例 
Fs 











代码 清单 9-9 ”从 多 个 通道 中 选择 














package main 


import ( 
"fmt" 


) 


func callerA(c chan string) { 
c «- "Hello World!" 


} 


func callerB(c chan string) { 
c «- "Hola Mundo!" 


j 


func main() { 
a, b := make(chan string), make(chan string) 
go callerA(a) 
go callerB(b) 
for i := 0; i < 5; i++ { 
select { 
case msg := <-a: 
fmt.Printf("%s from A\n", msg) 
case msg := <-b: 
fmt.Printf("%s from B\n", msg) 





这 个 程序 中 的 callerA 和 callerB 两 个 函数 都 会 接受 一 个 字符 串通 
道 作 为 参数 ， 并 向 该 通道 发 送信 息 。 在 以 goroutine 方 式 调用 callerA 和 
callerB 之 后 ， 程 序 会 进行 5 次 从 代 《次 数 的 多 少 无 关 紧 要 ，5 是 一 个 随 
意 选 取 的 数字 ) ， 并 且 在 每 次 迭代 中 ，Go 的 运行 时 环境 都 会 根据 通道 a 











或 者 通道 b 是 否 有 值 来 决定 应 该 对 哪个 通道 执行 取 值 操作 。 如 有 果 两 个 通 
道 都 有 值 ， 那 么 Go 运行 环境 将 随机 选择 其 中 一 个 通道 。 

我 们 的 计划 听 上 去 似乎 完美 无 一 ， 但 是 在 实际 运行 程序 的 时 候 ， 
Go 却 疝 我 们 报告 了 一 个 死 锁 错误 : 


Hello World! from A 
Hola Mundo! from B 


fatal error: all goroutines are asleep - deadlock! 





出 现 这 个 错误 的 原因 我 们 前 面 已 经 提 到 过 了 ， 当 一 个 goroutine 取 出 
无 缓冲 通道 中 唯一 的 值 之 后 ， 无 缓冲 通道 将 变 为 空 ， 之 后 任何 答 试 从 至 
通道 获取 值 的 goroutine 都 会 被 阻塞 并 进入 休眠 状态 。 在 这 个 例子 
H, main 函数 首先 在 第 一 次 达 代 中 从 通道 a 里 取出 了 值 ， 并 导致 通道 a 
KT: 接着 叉 在 第 二 次 迭代 中 从 通道 b 里 取出 了 值 ， 并 导致 通道 b 为 
空 ， 然 后 在 进行 第 三 次 迭代 时 ，main 函数 发 现 通道 a 和 通道 b 都 为 空 ， 
于 是 它 就 会 被 阻塞 并 进入 休眠 ， 但 由 于 这 时 callerA 和 callerB 这 两 个 
goroutine 都 已 执行 完毕 ， 所 以 通道 a 和 通道 b 将 永远 也 不 会 再 有 值 ， 
而 main 函数 也 只 能 永远 等 待 下 去 一 一 在 检测 到 这 一 情况 之 后 ，Go 运 行 
时 环境 抛 出 了 和 死 锁 错误 。 





解决 这 个 问题 并 不 困难 ， 我 们 只 需要 为 select 语句 添加 一 个 默认 
分 文 ， 让 select 语句 在 所 有 可 选 通 首都 已 被 阻 暑 的 情况 下 执行 默认 分 
支 即 可 ， 以 下 代码 中 加 粗 的 部 分 就 是 新 添加 的 默认 分 文 : 


select { 
case msg := < -a: 
fmt.Printf("%s from A\n", msg) 
case msg := < -b: 

fmt.Printf("Xs from B\n", msg) 
default: 


fmt.Println("Default") 





"1select 语句 没有 发 现任 何 可 用 的 通道 时 ， 它 就 会 执行 默认 分 文 
中 的 代码 。 对 于 上 面 的 例子 来 说 ， 当 存储 在 通道 a 和 通道 b 里 面 的 值 都 
被 取出 之 后 ， 程 序 残 会 在 下 一 次 达 代 中 执行 默认 分 支 中 的 代码 。 但 是 ， 





ee 这 是 因为 
程序 太 早 就 调用 select 语句 了 ， 以 至 于 通道 a 和 通道 b 还 没 来 得 及 接受 
callerA 和 callerB 发 送 给 它们 的 值 ， ee 才 两 个 还 没有 
值 的 通道 直接 执行 默认 分 文 了 。 为 了 让 这 个 程序 能 够 正确 工作 ， 我 们 需 
要 在 每 次 欠 代 之 前 添加 1s 的 延迟 ， 从 而 使 通道 能 够 正常 接收 goroutine 发 
送 给 它们 的 值 ， 以 下 代码 中 加 粗 显 示 的 惑 是 新 添加 的 语句 : 





for i:20;i« 5; i++ { 
time.Sleep(1 * time.Microsecond) 


select ( 
case msg :- « -a: 
fmt.Printf("Xs from A\n", msg) 


case msg :- « -b: 
fmt.Printf("Xs from B\n", msg) 
default: 
fmt.Println("Default") 
} 
} 





运行 这 个 修改 后 的 程序 ， 死 锁 将 不 会 再 出 现 : 


Hello World! from A 
Hola Mundo! from B 
Default 


Default 
Default 








从 程序 输出 的 结果 可 以 看 到 ， 在 通道 a 和 通道 b 包含 的 值 都 被 取出 
之 后 ，select 语句 的 前 两 个 分 文 就 会 被 阻 守 ， ve M 
行 。 





在 循环 里 添加 延迟 时 间 的 做 法 初 看 上 去 会 让 人 感觉 有 些 奇 怪 ， 但 这 





只 是 为 了 展示 select 语句 的 用 法 而 想 出 来 的 权宜 之 计 。 在 实际 
e 大 部 分 情况 下 用 户 使 用 的 部 是 无 限 循环 ， 而 不 是 有 限 次 数 的 达 代 ， 
这 时 程序 的 处 理 方式 就 会 有 所 不 同 。 比 如 ， 如 果 我 们 是 在 一 个 无 限 循环 
中 使 用 select 语句 ， 那 么 在 所 有 通道 都 为 空 之 后 ， 程 序 将 无 限 次 执行 
默认 分 文 ， 这 时 我 们 就 可 以 对 默认 分 文 的 执行 次 数 进行 计数 ， 并 在 计数 
到 达 指 定 限制 时 退出 循环 。 








其 实在 实际 中 ， 我 们 并 不 需要 像 上 面 所 说 的 那样 ， 通 过 计数 器 来 退 
出 带 有 select 语句 的 无 限 循 环 ， PH es 函数 来 关 
闭 通 道 能 够 更 好 地 达到 这 一 目的 : 使 用 close 函数 关闭 通道 ， 相 当 于 向 

道 的 接收 者 表明 该 通道 将 不 会 再 收 到 任何 值 。 uude 

Men. 尝试 同一 个 已 关闭 的 通道 发 送信 息 将 会 引发 一 个 panic， 
尝试 关闭 一 个 已 经 被 关闭 的 通道 也 是 如 此 。 尝 试 从 一 个 已 关闭 的 通道 取 
值 总 是 会 得 到 一 个 与 通道 类 型 相对 应 的 零 值 ， 因 此 从 已 关闭 的 通道 取 值 
JE RS Sgoroutineti [H £ , 














代码 清单 910 展 示 了 一 个 例子 ， 在 这 个 例子 中 ， 我 们 将 会 看 到 关闭 
道 的 方法 以 及 被 关闭 通道 是 如 何 帮助 程序 跳出 无 限 循环 的 。 





代码 清单 9-10 关闭 通道 




















package main 


import ( 
" fmt " 
) 


func callerA(c chan string) { 
c «- "Hello World!" 
close(c) e 

)e 


func callerB(c chan string) { e 
c «- "Hola Mundo!" e 
close(c) e 


} 


func main() { 
a, b := make(chan string), make(chan string) 
go callerA(a) 
go callerB(b) 
var msg string 


ok1，ok2 := true, true 
for ok1 || ok2 { 
select ( 
case msg, ok1 = «-a: e 
if ok1 ( e 
fmt.Printf("7s from AWMn", msg) e 
)e 
case msg, ok2 = «-b: e 
if ok2 ( e 
fmt.Printf("7s from B\n", msg) 
j 
j 
j 
j 





O 在 函数 被 调用 之 后 关闭 通道 


O 在 通道 被 关闭 之 后 ， 变 量 ok1 和 ok2 的 值 将 被 设置 为 false 


这 个 新 程序 不 再 只 达 代 5 次 ， 并 且 它 也 不 需要 在 过 代 之 前 添加 时 间 
延迟 。 在 将 一 个 字符 串 发 送 至 通道 之 后 ， 程 序 调用 内 置 的 close 函数 天 
闭 了 该 通道 。 需 要 注意 的 是 ， 跟 关闭 文件 或 者 关闭 套 接 字 不 一 样 ， 关 闭 
通道 并 不 会 导致 通道 的 机 能 完全 停止 一 一 它 的 作用 就 是 通知 其 他 正在 尝 
试 从 这 个 通道 接收 值 的 goroutine， 这 个 通道 已 经 不 会 再 接收 到 任何 值 
To 














男 外 需要 注意 的 是 ， 程 序 在 从 通道 里 面 取 值 时 ， 使 用 的 是 多 值 格式 


(multivalue form) : 


case value, ok1 = «-a 


在 执行 这 条 语句 时 ， 从 通道 a 里 面 取出 的 值 将 被 赋值 给 变量 value 
， 而 变量 ok1 则 会 被 设置 为 用 于 表示 通道 是 否 仍然 处 于 打开 状态 的 布尔 
值 。 如 果 通 道 已 被 关闭 ， 那 么 ok1 的 值 将 被 设置 为 false 。 

















到 任何 值 而 已 。 在 代码 清单 9-10 剩 余 的 代码 中 ， 程 序 将 通过 检测 语句 来 
判断 通道 是 否 已 被 关闭 ， 并 在 通道 已 被 关闭 的 情况 下 ， 跳 出 循环 ， 不 再 
打印 任何 信息 。 下 面 是 执行 该 程序 得 出 的 结 


Hello World! from A 
Hola Mundo! from B 


9.4 在 Web 应 用 中 使 用 并 发 








直到 目前 为 止 ， 本 章 都 是 在 独立 的 程序 中 展示 如 何 使 用 Go 的 并 发 
特性 ， 但 是 显然 地 ， 这 些 并 发 特性 不 仅 可 以 在 独立 的 程序 中 使 用 ， 还 可 
以 在 Web 应 用 中 使 用 。 在 这 一 节 中 ， 我 们 将 把 注意 力 放 到 Go Web Fi 
上 ， 并 学 习 如 何 使 用 并 发 特性 去 提高 Go Web 应 用 的 性 能 。 我 们 不 仅 会 
使 用 前 面 己 经 介绍 过 的 一 些 基 础 技术 ， 而 且 还 会 了 解 一 些 出 现在 实际 
Web 应 用 中 的 并 发 模式 。 





在 本 节 中 ， 我 们 将 要 创建 一 个 对 图 片 进行 马赛 元 处 理 ， 以 此 来 生成 


马赛 殉 图 片 的 Web 应 用 。 对 图 片 进行 马赛 赤 (mosaic) 处 理 ， 指 的 是 将 
图 片 分 割 成 多 个 (通常 是 大 小 相同 的 ) 和 矩形 截面 ， 然 后 使 用 一 些 被 称 为 
瓷砖 图 片 (tile picture) 的 新 图 片 去 代 蔡 截面 原 有 的 图 片 。 马 赛 殉 图 片 
的 奇妙 之 处 在 于 ， 如 果 人 们 从 足够 远 的 地 方 观 察 ， 或 者 以 斜视 的 角度 观 
察 ， 束 会 看 到 图 片 在 进行 马 完 克 处 理 之 前 的 样子 ， 相 反 ， 如 果 人 们 凑 近 
去 观察 马 哆 元 图 片 ， 就 会 发 现 它 们 其 实 是 由 成 百 上 干 张 尺寸 更 小 的 疙 砖 
图 片 组 成 。 

这 个 生成 马赛 克 图 乒 的 web 应 用 的 基本 想法 非常 简单 : 它 接收 用 户 
上 传 的 目标 图 片 (target picture) ， 然 后 据 此 生成 相应 的 马赛 殉 图 片 。 
为 了 让 事情 保持 简单 ， 我 们 假设 次 砖 图 片 已 经 事先 准备 好 了 ， 并 且 它 们 
都 已 经 被 裁剪 到 了 合适 的 大 小 。 


9.4.1 创建 马赛 克 图 片 


创建 马赛 克 图 片 的 第 一 步 是 定义 一 个 马赛 克 算法 ， 下 面 是 一 个 无 需 
使 用 任何 第 三 方 库 的 算法 步 又 。 





(1) 通过 扫描 图 片 目录 ， 并 使 用 图 片 的 文件 名 作为 键 、 图 片 的 平 
均 颜 色 作 为 值 ， ee 也 就 是 一 个 总 砖 图 
片 数据 库 。 通 过 计算 图 片 中 每 个 像素 红 、 绿 、 蓝 3 种 颜色 的 总 和 ， 并 将 
它们 除 以 像素 的 总 数量 ， MT HE 而 这 个 三 元 组 就 是 
图 片 的 平均 颜色 。 


(2) 根据 爸 砖 图 片 的 大 小 ， 将 目标 图 片 切割 成 一 系列 尺寸 更 小 的 
子 图 片 。 





(3) 对 于 目标 图 片 切割 出 的 每 张 子 图 片 ， 将 它们 位 于 左上 方 的 第 


一 个 像素 设 定 为 该 图 片 的 平均 颜色 。 


(4) 根据 子 图 片 的 平均 颜色 ， 在 瓷砖 图 片 数据 库 中 找 出 一 张 平均 
颜色 与 之 最 为 接近 的 瓷砖 图 片 ， 然 后 在 目标 图 片 的 相应 位 置 上 使 用 瓷砖 
图 片 去 代替 原 有 的 子 图 片 。 为 了 找 出 最 接近 的 平均 颜色 ， 程 序 需 要 将 子 
图 片 的 平均 颜色 以 及 瓷砖 图 片 的 平均 颜色 都 转换 成 三 维 空间 中 的 一 个 
点 ， 并 计算 这 两 点 之 间 的 欧 几 里 得 距离 。 














(50 当 一 张 疾 砖 图 片 被 选中 之 后 ， 程 序 就 会 把 这 张 图 片 从 次 砖 图 
片 数据 库 中 移 除 ， 以 此 来 保证 马赛 克 图 片 中 的 每 张 瓷砖 图 片 都 是 独 一 无 
二 、 各 不 相同 的 。 








文件 mosaic.go 实现 了 上 述 的 马赛 元 算法 ， 我 们 接 下 来 将 逐一 分 析 
该 文件 包含 的 各 个 函数 。 首 先 ， 代 码 清单 9-11 展 示 了 该 文件 中 用 于 计算 
平均 颜色 的 averageColor 函数 。 











代码 清单 9-11 averageColor 函数 














func averageColor(img image.Image) [3]float64 ( 
bounds :- img.Bounds() 
r, g, b := 0.0, 0.0, 0.0 
for y := bounds.Min.Y; y < bounds.Max.Y; y++ ( 
for x := bounds.Min.X; x < bounds.Max.X; x++ ( 
r1, g1, b1, _ := img.At(x, y).RGBA() 
r, g, b = r«float64(r1), g«float64(g1), b+float64(b1) e 


} 
} 
totalPixels := float64(bounds.Max.X * bounds.Max.Y) 
return [3]float64{r / totalPixels, g / totalPixels, b / totalPixels) 
} 





e 计算 出 给 定 图 片 的 平均 颜色 


averageColor 函数 会 把 给 定 图 片 的 每 个 像素 中 的 红 、 绿 、 监 3 种 
颜色 相 加 起 来 ， 并 将 这 些 颜 色 的 总 和 除 以 图 片 的 像素 数量 ， 最 后 把 除法 
计算 的 结果 记录 在 一 个 新 创建 的 三 元 组 里 面 〈 这 个 三 元 组 使 用 包含 3 个 
元 素 的 数组 表示 ) 。 





之 后 ， 程 序 会 使 用 代码 清单 9-12 所 示 的 resize 函数 ， 把 图 片 缩 放 
至 指定 的 宽度 。 

















代码 清单 9-12” resize 函数 











func resize(in image.Image, newWidth int) image.NRGBA { e 

bounds := in.Bounds() 

ratio :- bounds.Dx()/ newWidth 

out :- image.NewNRGBA(image.Rect(bounds.Min.X/ratio, bounds.Min.X/ratio, 
w.bounds.Max.X/ratio, bounds.Max.Y/ratio)) 

for y, j := bounds.Min.Y, bounds.Min.Y; y < bounds.Max.Y; y, j = y+ratio 


3 
j+1 { 
for x, i := bounds.Min.X, bounds.Min.X; x < bounds.Max.X; x, i = 
eex-ratio, i41 ( 
r, g, b, a := in.At(x, y).RGBA() 
Oout.SetNRGBA(i, j, color.NRGBA(uint8(r»»8), uint8(g»»8), uint8(b»»8) 


e uint8(a»»8))) 
} 
} 


return *out 


} 





O 将 给 定 图 片 缩放 至 指定 宽度 


代码 清单 9-13 展 示 了 tilesDB 函数 ， 这 个 函数 会 通过 扫 摘 瓷砖 图 片 
所 在 的 目录 来 创建 一 个 瓷砖 图 片 数 据 库 。 








代码 清单 9-13 tilesDB 函数 

















func tilesDB() map[string][3]float64 ( e 
fmt.Println("Start populating tiles db ..." 
db := make(map[string][3]float64) 
files, := ioutil.ReadDir("tiles") 
for , f := range files ( 
name := "tiles/" + f.Name() 
file, err := os.Open(name) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 
db[name] = averageColor(img) 
) else { 
fmt.Println("error in populating TILEDB:", err, name) 


I 
) else { 
fmt.Println("cannot open file", name, err) 


file.Close() 
j 
fmt.Println("Finished populating tiles db.") 
return db 


} 





自在 内 存 中 创建 一 个 瓷砖 图 片 数据 库 


瓷砖 图 片 数据 库 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 而 值 则 为 三 
元 组 〈 在 程序 中 使 用 包含 3 个 元 素 的 数组 来 表示 ) 。tilesDB 函数 会 打 
开 目 录 中 的 每 张 图 片 ， 并 根据 这 些 图 片 的 平均 颜色 在 映射 中 创建 相应 的 
记录 。 为 了 寻找 与 目标 图 片 相 匹配 的 瓷砖 图 片 ， 程 序 会 将 tilesDB 函数 
创建 的 瓷砖 图 片 数据 库 以 及 目标 图 片 的 平均 颜色 传 入 nearest 函数 。 








func nearest(target [3]float64, db *map[string][3]float64) string ( e 

var filename string 
smallest :- 1000000.0 
for k, v :- range *db ( 

dist :- distance(target, v) 

if dist « smallest ( 

filename, smallest - k, dist 

} 

} 


delete(*db, filename) 
return filename 
} 


€) 寻找 与 目标 图 片 平 均 颜 色 最 接近 的 瓷砖 图 片 








nearest RAAR TEE me EA Fr Fe Hm BS PPS Vo Hb ES Fr RAE S 
颜色 一 一 进行 对 比 ， 而 两 者 欧 几 里 得 距离 最 短 的 那 一 条 记录 ， 就 是 与 目 
标 图 片 平 均 颜 色 最 为 接近 的 瓷砖 图 片 。 函 数 会 从 数据 库 中 移 除 被 选中 的 

瓷砖 图 片 ， 并 把 该 图 片 的 名 字 返 回 给 调用 者 。 代 码 清单 9-14 展 示 了 用 于 
计算 两 个 三 元 组 之 间 的 欧 几 里 得 距离 的 distance 函数 。 

















代码 清单 9-14 distance 函数 














func distance(p1 [3]float64, p2 [3]float64) float64 ( e 
return math.Sqrt(sq(p2[0]-p1[0]) + sq(p2[1]-p1[1]) + sa(p2[2]-p1[2])) 


} 
func sq(n float64) float64 ( e 
return n * n 


} 





O 计算 两 点 之 间 的 欧 几 里 得 距离 


O 计算 给 定数 值 的 平方 











因为 扫描 和 载 入 侈 砖 图 片 数据 库 是 一 项 非常 花 时 间 的 操作 ， 上 所 以 为 
了 效率 起 见 ， 比 起 每 次 生成 马赛 死 图 片 的 时 候 都 重复 一 壳 这 个 操作 ， 更 
合理 的 做 法 是 只 执行 一 次 这 个 操作 ， 创 建 出 一 个 瓷砖 图 片 数 据 库 的 原本 
(source) ， 然 后 在 每 次 生成 马赛 元 图 片 的 时 候 都 根据 这 个 原本 复制 出 
一 个 独立 的 副本 《clone) 。 代 码 清单 9-15 展 示 了 作为 瓷砖 图 片 数据 库 的 
原本 而 存在 的 TILEDB 全 局 变量 ，Web 应 用 在 启动 的 时 候 束 会 创建 并 填 








代码 清单 9-15 cloneTilesDB 函数 











var TILESDB map[string][3]float64 


func cloneTilesDB() map[string][3]floato4 { e 
db := make(map[string][3]float64) 
for k, v := range TILESDB { 
db[k] = v 
} 
return db 


} 





O 每 次 需要 生成 马赛 殉 图 片 的 时 候 ， 就 复制 出 一 个 瓷砖 图 片 数据 
库 副本 


9.4.2 4E vL I] Fr Web) H 


在 实现 了 马赛 克 生 成 函数 之 后 ， 我 们 接 下 来 就 可 以 实现 与 之 相对 应 
的 Web 应 用 了 。 代 码 清单 9-16 展 示 了 这 个 应 用 的 具体 代码 ， 这 些 代码 放 
在 了 main.go 文件 中 。 














代码 清单 9-16 “马赛克 图 片 Web 应 用 








package main 


import ( 
"bytes" 
"encoding/base64" 
"fmt" 
"html/template" 
"image" 
"image/draw" 
"image/jpeg" 
"net/http" 
"os" 
"strconv" 


func main() { 
mux := http.NewServeMux() 
files := http.FileServer(http.Dir("public")) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 
mux.HandleFunc("/", upload) 
mux.HandleFunc("/mosaic", mosaic) 


server := &http.Server( 
Addr: "127.0.0.1:8080", 
Handler: mux, 

j 


TILESDB - tilesDB() 
fmt.Println("Mosaic server started.") 
server.ListenAndServe() 


j 

func upload(w http.ResponseWriter, r *http.Request) ( 
t, _ := template.ParseFiles("upload.html") 
t.Execute(w, nil) 


} 


func mosaic(w http.ResponseWriter, r *http.Request) { 
tO := time.Now() 


r.ParseMultipartForm(10485760) 


file, , _ := r.FormFile("image") e 
defer file.Close() 
tileSize, _ := strconv.Atoi(r.FormValue("tile size")) 
original, , _ := image.Decode(file) e 
bounds := original.Bounds() 
newimage :- image.NewNRGBA(image.Rect(bounds.Min.X, bounds.Min.X, 


bounds.Max.X, bounds.Max.Y)) 


db := cloneTilesDB() e 

sp := image.Point(0, 0) e 

for y := bounds.Min.Y; y < bounds.Max.Y; y = y + tileSize ( © 
for x := bounds.Min.X; x < bounds.Max.X; x = x + tileSize ( 


r, g, b, _ := original.At(x, y).RGBA() 
color := [3]floate4(float64(r), float64(g), float64(b)) 


nearest := nearest(color, &db) 
file, err := os.Open(nearest) 
if err == nil ( 
img, , err := image.Decode(file) 
if err == nil ( 


t := resize(img, tileSize) 
tile :- t.SubImage(t.Bounds()) 
tileBounds := image.Rect(x, y, x«tileSize, y+tileSize) 
draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
) else { 
fmt.Println("error:", err, nearest) 
j 
) else { 
fmt.Println("error:", nearest) 
} 
file.Close() 
} 
} 


buf1 := new(bytes.Buffer) 
jpeg.Encode(buf1, original, nil) © 
originalStr := base64.StdEncoding.EncodeToString(buf1.Bytes()) 


buf2 := new(bytes.Buffer) 
jpeg.Encode(buf2, newimage, nil) 
mosaic :- base64.StdEncoding.EncodeToString(buf2.Bytes()) 
t1 :- time.Now() 
images := map[string]string( 
"original": originalstr, 
"mosaic": mosaic, 
"duration": fmt.Sprintf("Xv ", t1.Sub(t0)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 


} 





O 获取 用 户 上 传 的 目标 图 片 ， 以 及 瓷砖 图 片 的 尺寸 
O 对 用 户 上 传 的 目标 图 片 进行 解码 


e 复制 瓷砖 图 数据 库 


O 为 每 张 侈 砖 图 片 设置 起 始点 
O 对 目标 图 片 分 割 出 的 每 张 子 图 进行 迭代 


Q 将 图 片 编码 为 JPEG 格式 ， 然 后 通过 base64 字 符 串 将 其 传输 至 浏 


mosaic 函数 是 一 个 处 理 器 函数 ， 在 这 个 函数 里 包含 了 用 于 生成 马 
赛 殉 网 片 的 主要 逻辑 : 首先 ， 程 序 会 获取 用 户 上 传 的 目标 图 片 ， 并 从 表 
单 中 获取 瓷砖 图 片 的 尺寸 ; 接着 ， 程 序 会 对 目标 图 乒 进 行 解 码 ， 并 创建 
出 一 张 全 新 的 、 空 白 的 马 冤 元 图片; 之后， 程序 会 复制 一 份 送 砖 图 片 数 
据 库 ， 并 为 每 张 次 砖 图 片 设置 起 始点 Csource point) ， 而 这 一 起 始点 将 
在 稍 后 的 代码 中 被 image/draw 包 所 使 用 。 在 完成 了 上 述 的 准备 工作 之 
后 ， 程 序 就 可 以 开始 对 目标 图 片 分割 出 的 各 张 送 砖 图 片 尺 寸 的 子 图 片 进 
ITER T o 








对 于 每 张 被 分 割 的 子 图 片 ， 程 序 都 会 把 它 左 上 角 的 第 一 个 像素 设置 
为 该 图 片 的 平均 颜色 ， 然 后 在 疙 砖 图 片 数据 库 中 查找 与 该 颜色 最 为 接近 
的 翁 砖 图 片 。 在 找到 匹配 的 码 砖 图 片 之 后 ， 被 调用 的 函数 就 会 回程 序 返 
回 该 图 片 的 文件 名 ， 然 后 程序 束 可 以 打开 这 张 爹 砖 图 片 并 将 其 缩放 全 指 
定 的 瓷砖 图 片 太 寸 了 。 在 缩放 操作 执行 完毕 之 后 ， 程 序 就 会 把 最 终 得 到 
的 总 砖 图 片 绘制 到 之 前 创建 的 马赛 克 图 片上 。 














在 使 用 上 述 方法 生成 出 整 张 马赛 区 图 片 之 后 ， 程 序 首 先 会 将 其 编码 
为 JPEG 格 式 的 图 片 ， 然 后 再 将 图 片 编码 为 base64 格 式 的 字符 串 。 


之 后 ， 程 序 会 将 用 户 上 传 的 目标 图 片 以 及 新 鲜 出 炉 的 马赛 苑 图片 都 


发 送 到 代码 清单 9-17 中 展示 的 results .html 模板 中 。 正 如 代码 清单 中 

加 粗 部 分 的 代码 所 示 ， 这 个 模板 会 通过 数据 URL 以 及 乱入 Web 页 面 中 的 
base64 字 符 串 来 显示 被 传 入 的 两 张 图 片 。 注 意 ， 这 里 使 用 的 数据 URL 跟 
一 般 URL 的 作用 并 不 相同 ， 前 者 用 于 包含 给 定 的 数据 ， 而 后 者 则 用 于 指 
问 其 他 资源 。 
































代码 清单 9-17 用 于 展示 马赛 克 图 片 生成 结果 的 模板 





< IDOCTYPE html» 
« html» 
« head» 
< meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
< title»Mosaic« /title» 


< /head» 
< body» 
< div class-'container'» 
< div class-"col-md-6"» 
< img src-"data:image/jpg;base64,(( .original jj)" width-z"100X"» 


« div class-"lead"»Original« /div» 
< /div> 
< div class="col-md-6"> 
< img src="data:image/jpg;base64,{{ .mosaic jJ)" width="100%"> 


< div class-"lead"»Mosaic - (( .duration }} 


< /div> 
< /div> 
< div class-"col-md-12 center"> 
< a class="btn btn-lg btn-info" href="/">Go Back« /a» 
< /div> 
< /div> 
< br> 
< /body> 
< /html> 








假设 上 述 程序 位 于 mosaic 目录 当中 ， 那 么 我 们 可 以 在 构建 该 程序 


之 后 ， 通 过 执行 以 下 命令 ， 以 只 使 用 一 个 CPU 的 方式 去 运行 它 ， 并 得 到 
图 9-5 所 示 的 结果 : 


GOMAXPROCS=1 ./mosaic 
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图 9-5 ”基本 的 马赛 克 图 片 生成 Web 应 用 


在 完成 了 基本 的 马赛 克 图 片 生 成 Web 应 用 之 后 ， 我 们 接 下 来 要 考虑 
的 就 是 如 何 把 这 个 应 用 改造 成 相应 的 并 发 版 本 了 。 


9.4.3 ”并 发 版 马赛 元 图 片 生成 Web 应 用 


并 发 的 一 个 常见 用 途 是 提高 性 能 。 上 一 节 展 示 的 Web 应 用 在 为 151 
KB 大 小 的 JPEG 图 片 创建 马赛 克 图 片 时 需要 耗费 2.25 s， 它 的 性 能 并 不 值 


得 称道 ， 但 我 们 可 以 通过 并 发 来 提高 它 的 性 能 。 具 体 来 说 ， 我 们 将 使 用 
以 下 算法 来 构建 一 个 并 发 版 本 的 马 守 克 图 片 生成 Web 应 用 : 





D 将 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 ; 
(2) 同时 对 被 分 割 的 4 张 子 图 片 进行 马赛 区 处理 ; 
(3) 将 处 理 完 的 4 张 子 图 片 重新 合并 为 1 张 马 赛 元 图 片 。 


图 9-6 以 图 示 的 方式 描述 了 上 述 步 又 。 


2. 分 别 对 4 张 子 图 片 
进行 马赛 克 处 理 。 


1. 将 目标 图 片 


3.3 完 的 4 
分 割 为 4 等 份 。 将 处 理 完 的 4 张 子 图 上 


合并 为 1 张 马赛 克 图 片 。 





图 9-6 能够 更 快 地 生成 马赛 克 图 片 的 并 发 算法 


需要 注意 的 是 ， 这 个 算法 并 不 是 提高 性 能 的 唯一 方法 ， 也 不 是 实现 
并 发 版 本 的 唯一 方法 ， 但 它 是 一 个 相对 来 说 比较 简单 直接 的 方法 。 


为 了 实现 这 个 并 发 算法 ， 我 们 需要 对 mosaic 处 理 器 函数 做 一 些 修 
改 。 之 前 展示 的 程序 只 有 mosaic 这 一 个 创建 马赛 克 图 片 的 处 理 器 函 
数 ， 但 是 对 并 发 版 的 Web 应 用 来 说 ， 我 们 需要 从 mosaic 函数 中 分 离 出 
cut 和 combine 这 两 个 独立 的 函数 ， 然 后 再 在 mosaic 函数 中 调用 它 
们 。 代 码 清单 9-18 展 示 了 修改 后 的 mosaic R. 





D 





























代码 清单 9-18 并 发 版 的 mosaic 处 理 器 函数 

















func mosaic(w http.ResponseWriter, r *http.Request) ( 
tO := time.Now() 
r.ParseMultipartForm(10485760) // max body in memory is 10MB 
file, , _ := r.FormFile("image") 
defer file.Close() 
tileSize, := strconv.Atoi(r.FormValue("tile size")) 
original, , _ := image.Decode(file) 
bounds := original.Bounds() 
db := cloneTilesDB() 


c1 := cut(original, &db, tileSize, bounds.Min.X, bounds.Min.Y, 
w.bounds.Max.X/2, bounds.Max.Y/2)e 

C2 :- cut(original, &db, tileSize, bounds.Max.X/2, bounds.Min.Y, 
w.bounds.Max.X, bounds.Max.Y/2)e 

C3 := cut(original, &db, tileSize, bounds.Min.X, bounds.Max.Y/2, 
w.bounds.Max.X/2, bounds.Max.Y)e 

c4 := cut(original, &db, tileSize, bounds.Max.X/2, bounds.Max.Y/2, 
w.bounds.Max.X, bounds.Max.Y)e 

c := combine(bounds, c1, c2, c3, c4) e 


buf1 := new(bytes.Buffer) 
jpeg.Encode(buf1, original, nil) 
originalStr := base64.StdEncoding.EncodeToString(buf1.Bytes()) 


t1 :- time.Now() 
images := map[string]stringi( 
"original": originalstr, 
"mosaic": «-C, 
"duration": fmt.Sprintf("Xv ", t1.Sub(t0)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 


} 





O 以 布 形 散 开 方 式 分 割 图 片 以 便 单独 进行 处 理 
O 以 书 形 聚拢 方式 将 多 个 子 图 片 合并 成 一 个 完整 的 图 片 


cut 函数 会 以 扇形 散 开 (fan-out) 模式 将 目标 图 片 分 割 为 多 个 子 图 
片 ， 如 图 9-7 所 示 。 





图 9-7 将 目标 图 片 分 割 为 4 等 份 


用 户 上 传 的 目标 图 片 将 被 分 割 为 4 等 份 以 便 独立 处 理 。 注 意 ， 
在 mosaic 函数 里 ， 程 序 调 用 的 都 是 普通 函数 而 不 是 goroutine， 这 是 因 
为 程序 的 并 发 部 分 存在 于 被 调用 函数 的 内 部 : cut E Se pe 
goroutine7; AAT — E 4A PRAG, TAA E 4 BRL CU] Re] — 388 3 TE 
为 结果 。 





需要 注意 的 是 ， 因 为 我 们 正在 尝试 将 一 个 程序 转换 为 相应 的 并 发 版 
本 ， 而 并 发 程序 通常 都 需要 同时 运行 多 个 goroutine， 所 以 如 果 程 序 需要 
在 这 些 goroutine 之 间 共 享 一 些 资 源 ， 那 么 针对 这 些 资 源 的 修改 将 有 可 能 
会 导致 竞争 条 件 出 现 。 

















如 果 一 个 程序 在 执行 时 依赖 于 特定 的 顺序 或 时 序 ， 但 是 又 无 法 保证 这 种 顺序 或 时 序 ， 此 
时 就 会 存在 竞争 条 件 (race condition) 。 竞 争 条 件 的 存在 将 导致 程序 的 行为 变 得 球 包 不 定 而 
且 难 以 预测 。 



































苋 争 条 件 通 常 出 现在 那些 需要 修改 共享 资源 的 并 发 程序 当中 。 当 有 两 个 或 多 个 进程 或 线 
程 同 时 去 修改 一 项 共享 资源 时 ， 最 先 访问 资源 的 那个 进程 /线程 将 得 到 预期 的 结果 ， 而 其 他 进 
程 /线程 则 不 然 。 最 终 ， 因 为 程序 无 法 判断 哪个 进程 /线程 最 先 访问 了 资源 ， 所 以 它 将 无 法 产生 
一 致 的 行为 。 


































































































虽然 竞争 条 件 一 般 都 不 太 好 发 现 ， 但 修复 一 个 已 判明 的 竞争 条 件 通 常 来 说 并 不 是 一 件 难 








事 。 


本 节 介 绍 的 马赛 克 图 片 生成 Web 应 用 同样 也 拥有 共享 资源 : 用 户 在 
将 目标 图 片上 传 至 Web 应 用 之 后 ，nearest 函数 就 会 从 瓷砖 图 片 数 据 库 
中 寻找 与 之 最 为 匹配 的 瓷砖 图 片 ， 并 从 数据 库 中 移 除 被 选中 的 图 片 以 防 








相同 的 图 片 重复 出 现 。 这 就 意味 着， 如 果 多 个 cut 函数 中 的 goroutine 同 
时 找到 了 同一 总 砖 图 片 作 为 最 佳 玫 配 结果 ， 束 会 产生 一 个 竞争 条 件 。 





为 了 消除 这 一 苋 争 条 件 ， 我 们 可 以 使 用 一 种 名 为 了 互 斥 “(mutual 
exclusion， 人 简称 “mutex ”) 的 技术 ， 该 技术 可 以 将 同一 时 间 内 访问 临界 
[X 《critical section) 的 进程 数量 限制 为 一 个 。 对 马赛 克 图 片 生成 Web 应 
用 来 说 ， 我 们 需要 在 nearest 函数 中 实现 互 斥 ， 以 此 来 保证 同一 时 间 内 
只 能 有 一 个 goroutine 对 总 砖 图 片 数 据 库 进行 修改 。 


为 了 满足 这 一 点， 程序 需要 用 到 Go 标准 库 sync 包 中 的 Mutex 结 
构 。 首 先 要 做 的 是 定义 一 个 DB 结构 ， 并 在 该 结构 中 封装 实际 的 瓷砖 图 
片 数据 库 以 及 mutex 标志 ， 具 体 如 代码 清单 9-19 所 示 。 























代码 清单 9-19 DB 结构 














type DB struct ( 
mutex *sync.Mutex 


store map[string][3]float64 
} 





接着 ， 如 代码 清单 9-20 所 示 ， 将 nearest 函数 修改 为 DB 结构 的 一 
个 方法 。 








代码 清单 9-20 nearest 方法 








func (db *DB) nearest(target [3]float64) string { 

var filename string 
db.mutex.Lock() @ 
smallest := 1000000.0 
for k, v := range db.store { 

dist :- distance(target, v) 

if dist « smallest ( 

filename, smallest - k, dist 


} 


delete(db.store, filename) 
db.mutex.Unlock() @ 
return filename 





O 通过 加 锁 设置 mutex 标志 


O 通过 解锁 移 除 mutex 标志 





需要 注意 的 是 ， 因 为 在 从 数据 库 里 移 除 被 选中 的 图 片 之 前 ， 多 个 
goroutine 还 是 有 可 能 会 把 相同 的 瓷砖 图 片 设置 为 最 佳 的 匹配 结果 ， 所 以 
只 锁 住 delete 函数 是 无 法 移 除 苋 争 条 件 的 ， 因 此 修改 后 的 nearest K 
数 将 把 寻找 最 佳 匹 配 瓷砖 图 片 的 整个 区 域 (section〉 都 锁 住 。 





代码 清单 9-21 展 示 了 cut 函数 的 具体 代码 。 





代码 清单 9-21 cut 函数 








func cut(original image.Image, db *DB, tileSize, x1, y1, x2, y2 int) «-cha 
n 


image.Image ( e 
c := make(chan image.Image) e 
sp := image.Point(0, 0) 
go func() ( e 
newimage :- image.NewNRGBA(image.Rect(x1, y1, x2, y2)) 
for y := yl; y < y2; y = y + tileSize ( 


for x := x1; X < X2; X = x + tileSize ( 
r, g, b, _ := original.At(x, y).RGBA() 
color :- [3]floate4(floate4(r), floate4(g), float64(b)) 
nearest :- db.nearest(color) e 
file, err := os.Open(nearest) 
if err == nil { 
img, , err := image.Decode(file) 
if err == nil { 
t := resize(img, tileSize) 


tile :- t.SubImage(t.Bounds()) 
tileBounds := image.Rect(x, y, x«tileSize, y+tileSize) 


draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
) else { 
fmt.Println("error:", err) 


} 
) else { 


fmt.Println("error:", nearest) 
j 
file.Close() 


j 
c <- newimage.SubImage(newimage.Rect) 
}() 


return c 


} 





Q 把 指向 DB 结构 的 引用 传递 给 DB 结构 ， 而 不 是 仅仅 传 入 一 个 映 
Tf 


O 这 个 通道 将 作为 函数 的 执行 结果 返回 给 调用 者 


e 创建 匿名 的 goroutine 





O 调用 DB 结构 的 nearest 方法 来 获取 最 匹配 的 瓷砖 图 片 





并 发 版 的 马 冤 元 图 片 生 成 Web 应 用 跟 原 来 的 非 并 发 版 本 拥有 相同 的 
逻辑 : 它 首 移 在 cut 函数 里 创建 一 个 通道 ， 并 局 动 一 个 匿名 goroutine 来 
计算 将 要 被 发 送 至 该 通道 的 马赛 克 处 理 结果 ， 接 着 再 把 这 个 通道 返回 给 
cut 函数 的 调用 者 。 这 样 一 来 ，cut 函数 创建 的 通道 就 会 立即 返回 给 
mosaic 处 理 占 函数 ， 而 通道 对 应 的 号 赛 克 子 图 片 则 会 在 处 理 完毕 之 后 
被 发 送 至 通道 。 另 外 需要 注意 的 是 ， 虽 然 cut 函数 创建 的 是 一 个 双 回 通 
道 ， 但 是 如 果 需 要， 我 们 也 可 以 在 返回 这 个 通道 之 前 ， 通 过 类 型 转换 

(typecast) 将 它 转换 成 一 个 只 能 接收 信息 的 单 同 通道 。 








在 把 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 并 将 它们 分 别 转换 为 马赛 克 
图 片 的 一 部 分 之 后 ， 程 序 接 下 来 束 会 调用 代码 清单 9-22 所 示 的 combine 
函数 ， 通 过 山形 聚 扰 (fan-in〉 模式 ， 将 4 张 子 图 片 重新 合并 成 1 张 完整 
的 马赛 区 图 片 。 








代码 清单 9-22 combine PAZ 

















func combine(r image.Rectangle, c1, c2, c3, c4 «-chan image.Image) 
«-chan string { 
c := make(chan string) e 


go func() ( e 
var wg sync.WaitGroup e 
img:- image.NewNRGBA(r) 
copy := func(dst draw.Image, r image.Rectangle, 
src image.Image, sp image.Point) { 
draw.Draw(dst, r, src, sp, draw.Src) 
wg.Done() e 
} 
wg.Add(4) e 
var s1, s2, s3, s4 image.Image 
var ok1, ok2, ok3, ok4 bool 
for ( e 
select ( © 
case s1, ok1 - «-c1: 
go copy(img, si.Bounds(), s1, 
image.Point(r.Min.X, r.Min.Y)) 
case s2, ok2 = «-c2: 
go copy(img, s2.Bounds(), s2, 
image.Point(r.Max.X / 2, r.Min.Y)) 
case s3, ok3 = «-c3: 
go copy(img, s3.Bounds(), s3, 
image.Point(r.Min.X, r.Max.Y/2)) 
case s4, ok4 = «-c4: 
go copy(img, s4.Bounds(), s4, 
image.Point(r.Max.X / 2, r.Max.Y / 2}) 


} 

if (ok1 && ok2 && ok3 && ok4) ( e 
break 

} 


} 


wg.Wait() e 


buf2 := new(bytes.Buffer) 
jpeg.Encode(buf2, img, nil) 
C «- base64.StdEncoding.EncodeToString(buf2.Bytes()) 
0 
return c 


} 





@ 这 个 函数 将 返回 一 个 通道 作为 执行 结 

e 创建 一 个 匿名 goroutine 

O 使 用 等 竺 组 去 同步 各 个 子 图 片 的 复制 操作 

O 每 复制 完 一 张 子 图 片 ， 就 对 计数 器 执行 一 次 减 一 操作 
O 把 等 待 组 计数 器 的 值 设置 为 4 

Q 在 一 个 无 限 循 环 里 面 等 待 所 有 复制 操作 完成 

O 等 行 各 个 通道 的 返回 值 

O 当 所 有 通道 都 被 关闭 之 后 ， 跳 出 循环 

O 阻塞 直到 所 有 子 图 片 的 复制 操作 都 执行 完毕 为 止 


JR cut 函数 一 样 ， 合 并 多 张 子 图 片 的 主要 逻辑 也 放 到 了 匿名 
goroutine 中 ， 并 且 这 些 goroutine 同 样 会 创建 并 返回 一 个 只 能 执行 接收 操 
作 的 通道 作为 结果 。 这 样 一 来 ， 程 序 就 可 以 在 编码 目标 图 片 的 同时 ， 对 
马赛 克 图 片 的 4 个 部 分 进行 合并 。 


在 combine 函数 创建 的 匿名 goroutine 里 ， 程 序 会 构建 另 一 个 匿名 函 


数 ， 并 将 其 赋值 给 变量 copy 。copy 函数 之 后 同样 会 以 goroutine 方 式 运 
行 ， 并 将 给 定 的 马赛 元 子 图 片 复 制 到 最 终 的 马赛 元 图 片 中 。 与 此 同时 ， 
因为 程序 无 法 得 知 以 goroutine 方 式 运 行 的 copy 函数 将 于 何 时 结束 ， 所 
以 它 使 用 了 等 竺 组 来 同步 这 些 复制 操作 。 程 序 首 移 创 建 一 个 NaitGroup 
变量 wg ， 并 使 用 Add 方法 将 计数 器 的 值 设置 为 4 。 之 后 ， 每 当 一 个 复制 
操作 执行 完毕 的 时 候 ，copy 函数 都 会 调用 Done 方法 ， 把 等 竺 组 计数 器 
的 值 减 1。 最 后 ， 程 序 把 一 个 Nait 方法 调用 放 在 了 最 终生 成 的 马赛 克 图 
片 的 编码 操作 之 前 ， 以 此 来 保证 程序 只 会 在 所 有 复制 goroutine 都 已 执行 
完毕 ， 并 且 程 序 已 经 拥有 了 完整 的 最 终 马 冤 克 图 片 之 后 ， 才 会 开始 对 图 
片 进行 编码 。 








一 个 需要 注意 的 地 方 是 ，combine 函数 接受 的 输入 包含 了 4 个 来 自 
cut 函数 的 通道 ， 这 些 通道 包含 了 马赛 元 图 片 的 各 个 组 成 部 分 ， 并 且 程 
序 不 知道 这 些 部 分 何 时 才 会 通过 通道 传输 过 来 。 虽 然 程 序 可 以 按 顺 序 一 
个 接 一 个 从 这 些 通道 里 接收 信息 ， 但 这 种 做 法 并 不 符合 并 发 程序 的 风 
格 。 为 此 ， 程 序 使 用 了 select 方法 ， 以 先 到 先 服务 的 方式 来 接收 这 些 
通道 发 送 的 信息 。 





这 样 做 的 结果 是 ， 程 序 会 在 一 个 无 限 循环 里 面 进行 欠 代 ， 并 且 每 次 
迭代 都 会 使 用 select 去 获取 其 中 一 个 已 就 绪 通 道 传送 的 子 图 片 〈 如 采 
同时 有 多 个 子 图 片 可 用 ， 那 么 Go 将 随机 选择 其 中 一 个 ) ， 然 后 以 
goroutine 方 式 执行 copy 函数 ， 将 接收 到 的 子 图 片 复 制 到 最 终生 成 的 马 
完 元 图 片 当中 。 因 为 程序 使 用 了 多 值 格 式 (multivalue format) Kuk 
道 的 返回 值 ， 而 通道 的 第 二 个 返回 值 ( 即 ok1 、ok2 、ok3 和 ok4 ) 可 
以 说 明 程 序 是 否 已 经 成 功 地 接收 了 各 个 通道 传送 的 子 图 片 ， 所 以 在 无 限 








循环 的 末尾 ， 程 序 会 通过 检测 这 些 返 回 值 来 决定 是 否 跳 出 循环 。 





因为 程序 在 接收 到 所 有 子 图 片 之 后 ， 还 需要 在 4 个 goroutine 里 分 别 
复制 这 些 子 图 片 ， 而 这 些 复制 操作 的 完成 时 间 是 不 确定 的 。 为 了 解决 这 
个 问题 ， 程 序 会 调用 之 前 定义 的 等 竺 组 变量 wg 的 Wait 方法 ， 对 最 终生 
成 的 马赛 克 图 片 的 编码 操作 进行 阻塞 ， 直 到 上 述 复 制 操作 全 部 执行 完毕 
为 止 。 

现在 ， 我 们 终于 拥有 了 一 个 并 发 版 的 马 冤 元 图 片 生成 Web 应 用 ， 接 
下 来 是 时 候 运 行 一 下 它 了 。 首 先 ， 假 设 程序 位 于 mosaic_concurrent 
目录 当中 ， 那 么 在 使 用 go build 构建 该 程序 之 后 ， 我 们 可 以 通过 执行 
以 下 命令 ， 使 用 单个 CPU 去 运行 它 : 


GOMAXPROCS=1 ./mosaic concurrent 


如 果 一 切 正常 ， 将 会 看 到 图 9-8 所 示 的 结果 ， 生 成 这 个 结果 时 使 用 
的 目标 图 片 以 及 总 砖 图 片 跟 之 前 运行 非 并 发 版 本 时 是 完全 一 样 的 。 











由 于 并 发 版 程序 在 将 4 张 子 图 片 合 并 成 1 张 完整 的 马赛 克 图 片 的 时 
候 ， 没 有 对 子 图 片 的 毛 边 进行 平滑 处 理 ， 所 以 如 果 你 仔细 对 比 就 会 发 
现 ， 这 次 生成 的 马赛 元 图 片 跟 之 前 非 并 发 版 本 生成 的 马赛 克 图 片 是 有 一 
点 细微 区 别 的 《从 彩色 显示 的 电子 书 上 会 更 为 明显 地 看 出 这 一 点 ) 。 尽 
管 生成 的 马赛 克 图 片 有 些 细微 的 不 同 ， 但 并 发 版 程序 的 性 能 提升 是 非常 
明显 的 一 一 非 并 发 版 的 马赛 克 图 片 生 成 Web 应 用 处 理 相同 的 目标 图 片 耗 
费 了 2.25s， 而 并 发 版 本 只 耗费 了 646 hs， 后 者 的 性 能 比 前 者 提高 了 几乎 
有 4 倍 之 多 。 
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图 9-8 ”并 发 版 的 马赛 克 照 片 生成 Web 应 用 





初 看 上 去 ， 我 们 所 做 的 似乎 只 是 将 一 个 函数 分 割 成 4 个 独立 运行 的 
goroutine， 以 此 来 实现 一 个 并 发 版 本 的 Web 程 序 ， 但 如 果 我 们 再 进 一 
步 ， 以 并 行 的 方式 去 运行 这 个 程序 ， 结 果 又 会 如 何 呢 ? 


别 筷 了 ， 在 前 面 的 程序 中 ， 我 们 不 仅 将 一 个 运行 非常 耗 时 的 处 理 器 
函数 分 割 成 了 几 个 独立 运行 的 cut 函数 goroutine， 而 且 我 们 还 
在 combine 函数 里 使 用 多 个 goroutine 来 独立 地 组 合 马赛 克 图 片 的 各 个 部 
分 。 每 当 一 个 cut 函数 完成 了 它 的 工作 之 后 ， 它 就 会 将 处 理 的 结果 发 送 
给 与 之 对 应 的 combine 函数 ， 而 后 者 则 会 将 这 一 结 末 复 制 到 最 终生 成 的 
马赛 元 图 片 当中 。 


除 此 之 外 ， 别 筷 了 ， 在 前 面 运行 非 并 发 版 本 和 并 发 版 本 的 马赛 区 图 
片 生成 Web 应 用 时 ， 我 们 都 只 使 用 了 一 个 CPU。 正 如 之 前 所 说 ， 并 发 不 
是 并 行 一 一 本 节 前 面 的 内 容 已 经 展示 了 如 何 将 一 个 简单 的 算法 分 解 为 
相应 的 并 发 版 本 ， 其 中 不 涉及 任何 并 行 计 算 : 尽管 这 些 goroutine 能 够 以 
并 发 方式 运行 ， 但 是 因为 只 有 一 个 CPU 可 用 ， 所 以 这 些 goroutine 实 际 上 
并 没有 以 并 行 的 方式 运行 。 








为 了 让 故事 有 一 个 圆满 的 结局 ， 现 在 我 们 可 以 通过 执行 以 下 命令 ， 
以 并 行 的 方式 ， 在 多 个 CPU 以 及 进程 上 运行 并 发 版 的 马赛 克 图 片 生成 
Web HH: 


./mosaic_concurrent 


图 9-9 展 示 了 上 述 命令 的 执行 结果 。 





正如 结果 中 打印 的 时 间 所 示 ， 并 行 运行 的 并 发 程序 比 单纯 的 并 发 程 
序 又 获得 了 大 约 3 倍 的 性 能 提升 ， 具 体 时 间 从 原来 的 646 hs 减少 到 了 现在 
的 216 us! 如 果 我 们 把 这 一 结果 跟 最 初 的 非 并 发 版 本 所 需 的 2.25 s 相 比 ， 
那么 新 程序 的 性 能 提升 足 有 10 倍 之 多 。 





对 马赛 克 图 片 生成 Web 应 用 来 说 ， 非 并 发 版 本 跟 并 发 版 本 使 用 的 图 
片 处 理 算法 是 完全 相同 的 。 实 际 上 ， 两 个 版 本 的 mosaic.go 源码 文件 天 
别 并 不 大 ， 它 们 之 间 的 主要 区 别 在 于 是 否 使 用 了 并 发 特性 ， 这 是 提高 程 
序 性 能 的 关键 。 





ese < 0 localhost E 5l 国 
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图 9-9 ”使 用 8 个 CPU 运行 并 发 版 的 马赛 克 图 片 生 成 Web 应 用 


完成 了 马赛 克 图 片 生 成 Web 应 用 之 后 ， 在 接 下 来 的 一 章 ， 我 们 要 考 
虑 的 就 是 如 何 部 署 Web 应 用 和 Web 服 务 了 。 


9.5 小结 





e Go Web 服 务 嚣 本 里 是 并 发 的 ， 服 务 器 会 把 接收 到 的 每 条 请 求 都 放 
到 独立 的 goroutine 里 运行 。 

。 并 发 和 并 行 是 两 个 相辅相成 的 概念 ， 但 它们 并 不 相同 。 并 发 指 的 是 
两 个 或 多 个 任务 在 同一 时 间 段 内 局 动 、 运 行 和 结束 ， 并 且 这 些 任 务 
可 能 会 彼此 互动 ， 而 并 行 则 是 单纯 地 同时 运行 多 个 任务 。 

e Go 通过 goroutine 和 通道 这 两 个 重要 的 特性 直接 支持 并 发 ， 但 Go 并 
不 直接 支持 并 行 。 











goroutine 用 于 编写 并 发 程序 ， 而 通道 则 用 于 为 不 同 的 goroutine 之 间 
提供 通信 功能 。 

无 缓冲 通道 都 是 同步 的 ， 和 尝试 向 一 个 已 经 包含 数据 的 无 缓冲 通道 推 
入 新 的 数据 将 被 阻塞 ， 但 是 ， 有 绥 冲 通道 在 被 填 满 之 前 都 是 异步 
的 。 

select 语句 可 以 以 先 到 先 服务 的 方式 ， 从 多 个 通道 里 选 出 一 个 已 
经 准备 好 执行 接收 操作 的 通道 。 

WaitGroup 同样 可 以 用 于 对 多 个 通道 进行 同步 。 

并 发 程序 的 性 能 一 般 都 会 比 相 应 的 非 并 发 程序 要 高 ， 而 具体 提升 多 
少 则 取决 于 所 使 用 的 算法 《即使 在 只 使 用 一 个 CPU 的 情况 下 ， 也 是 
WEY . 

在 条 件 允 许 的 情况 下 ， 并 发 的 Web 应 用 将 自动 地 获得 并 行 带 来 的 优 


势 。 





[1] 原 书 说 Go 1.4 goroutine 的 局 动 栈 大 小 为 8 KB， 但 根据 资料 ， 这 个 栈 
的 大 小 应 该 是 2KB 才 对 ， 所 以 在 译文 里 面 进行 了 修正 。《 资 料 链接 : 
https://golang.org/doc/gol.44runtime. ) 一 一 译 者 注 


第 10 章 Go 的 部 署 


e 把 Go Web 应 用 部 署 到 独立 服务 器 
e 把 Go Web 应 用 部 署 到 云端 
e 把 Go Web 应 用 部 署 到 Docker 容 器 





在 学 习 了 如 何 使 用 Go 开发 Web 应 用 之 后 ， 接 下 来 要 考虑 的 自然 就 是 
如 何 部 署 这 些 应 用 了 。Web 应 用 跟 其 他 类 型 的 应 用 在 部 获 方 式 上 存在 着 
非常 大 的 不 同 。 比 如 ， 昌 面 应 用 和 移动 应 用 就 是 部 署 在 智能 手机 、 平 板 
电脑 、 手 提 电 脑 等 终端 用 户 的 设备 上 ， 而 Web 应 用 则 是 部 嗜 在 服务 器 
上 ， 然 后 通过 终端 用 户 设备 上 的 浏览 喜 等 客户 端 对 其 进行 访问 。 








因为 Go 的 可 执行 程序 都 会 被 编译 为 单独 的 二 进 制 文件 ， 所 以 部 署 
Go Web 应 用 程序 在 某 种 程度 上 可 以 说 是 非常 简单 的 。 除 此 之 外 ，Go 还 
可 以 编译 出 不 需要 引用 任何 外 部 库 的 静态 链接 二 进 制 文 件 ， 这 种 文件 可 
以 作为 独立 的 可 执行 文件 存在 。 不 过 一 个 完整 的 Web 应 用 通常 不 会 只 包 
含 一 个 可 执行 文件 ， 它 一 般 还 会 包含 一 些 模板 文件 ， 以 及 诸如 
JavaScript、 图 片 、 样 式 表 (style sheet) 这 样 的 静态 文件 。 本 章 将 会 介 
绍 几 种 把 Go Web 应 用 部 署 到 互联 网 的 方法 ， 其 中 大 部 分 方法 都 是 通过 
云 供应 两 (cloud provider) 实现 的 。 本 章 将 要 介绍 的 部 署 方法 包括 : 











e 在 一 个 完全 由 用 户 本 人 控制 的 物理 或 虚拟 的 服务 器 上 实施 部 署 ， 本 
章 正 文 将 使 用 IaaS 供 应 商 Digital Ocean 的 服务 器 作为 例子 ; 


。 在 云 PaaS 供 应 商 Heroku 上 实施 部 署 ; 

e 在 男 一 家 云 PaaS 供 应 商 Google App Engine (GAE) 上 实施 部 署 ; 

。 将 应 用 Docker 化 (dockerized) 为 容器 ， 然 后 将 其 部 署 到 本 地 
Docker 服 务 器 以 及 Digital Ocean 的 虚拟 机 上 。 


| aa 





云 计 算 ， 简称 “< 去"， 是 一 种 获取 网 络 和 计算 机 使 用 权限 的 模型 ， 这 种 模型 可 以 提供 一 个 
由 服务 器、 存储 空间 、 网 络 以 及 其 他 可 共享 资源 组 成 的 共享 资源 池 ， 从 而 使 这 些 资源 的 用 户 
可 以 避免 不 必要 的 前 期 投入 ， 也 可 以 让 这 些 资源 的 供应 商 更 加 高 效 地 利用 这 些 资 源 为 更 多 的 
用 户 提 供 服 务 。 云 计算 在 最 近 这 些 年 吸引 了 非常 多 的 关注 ， 时 至 今日 ， 包 括 Amazon、Google 
和 Facebook 在 内 的 绝 大 部 分 基础 设施 以 及 服务 供应 商都 使 用 这 种 模型 作为 他 们 的 标准 收费 模 
型 。 















































需要 注意 的 是 ， 部 辕 一 个 Web 应 用 通常 会 有 很 多 种 不 同 的 方法 可 
选 ， 比 如 ， 本 章 介绍 的 几 种 部 署 方 法 之 间 就 存在 独 非常 多 的 不 同 之 处 。 
还 有 一 点 要 说 明 的 是 ， 本 章 介 绍 的 部 普 方 法 关注 的 是 如 何 部 车 个 人 的 
Web 应 用 ， 真 正 生 产 环境 下 的 部 署 通常 会 包含 运行 测试 僚 件 、 实 施 持续 
集成 以 及 调整 服务 占 等 一 系列 额外 的 任务 ， 具 体 过 程 会 比 这 里 介绍 的 要 
ERI. 











本 草 虽 然 介 绍 了 很 多 概念 和 工具 ， 但 由 于 这 些 概念 和 工具 每 个 都 什 
得 用 整整 一 本 书 的 访 幅 去 介绍 ， 所 以 本 半 并 没有 试图 全 面 讲解 这 些 技 术 
和 服务 。 相 反 ， 本 章 只 会 关注 这 些 技术 的 一 部 分 知识 ， 读 者 可 以 把 这 些 
知识 看 作 是 学 习 相 关 技 术 的 起 点 。 











本 章 展 示 的 部 署 例子 将 会 用 到 7.6 节 介绍 过 的 简单 Web 服 务 ， 并 在 条 
件 人 允许 的 情况 下 使 用 PostgreSQL (因为 GAE 不 文 持 PostgreSQL， 所 以 在 





介绍 GAE 的 部 蜀 方 法 时 ， 本 章 将 使 用 基于 MySQL 的 Google Cloud 
SQL) 。 与 此 同时 ， 本 章 还 会 假设 独立 的 数据 库 服 务 器 上 已 经 预先 设置 
好 了 数据 库 的 相关 设置 ， 所 以 本 章 将 不 会 介绍 具体 的 数据 库 设置 方法 ， 
有 需要 的 读者 可 以 通过 复习 2.6 节 来 获得 一 个 简短 的 设置 介绍 。 








10.1 将 应 用 部 普 到 独立 的 服务 需 


让 我 们 从 最 简单 的 部 署 方法 开始 一 一 创建 一 个 可 执行 的 二 进 制 文 
件 ， 并 将 它 放 到 互联 网 的 某 个 服务 器 上 运行 ， 这 个 服务 器 可 以 是 物理 存 
在 的 ， 也 可 以 是 由 Amazon Web Services (AWS) 或 者 Digital Ocean 等 供 
应 了 商 创 建 的 虚拟 机 VM) 。 在 本 节 中 ， 我 们 将 要 学 习 如 何在 运行 着 
Ubuntu Server 14.04 系 统 的 服务 器 上 部 署 Go WebM H o 








IaaSs、PaaS 和 SaaSs 
































云 计 算 供应 商都 会 通过 不 同 的 模型 来 为 用 户 提供 服务 。 美 国 国家 标准 技术 研究 所 
(National Institute of Standards and Technology, US Department of Commerce, NIST) XT% 
今 广 为 使 用 的 3 种 服务 模型 ， 分 别 是 基础 设施 即 服务 CInfrastructure-as-a-Service, laas) , ^F 
台 即 服务 (Platform-as-a- Service, PaaS) 和 软件 即 服 务 (Software-as-a-Service, SaaS) . 























IaaS 是 这 3 种 模型 中 最 为 基本 的 一 种 ， 使 用 这 种 模型 的 供应 商 将 向 他 们 的 用 户 提供 包括 计 
算 、 存 储 以 及 网 络 在 内 的 基本 计算 能 力 。 提 供 IaaS 服 务 的 例子 有 AWS 的 弹性 云 计算 服务 
(Elastic Cloud Computing Service, EC2) 、Google 公 司 的 Compute Engine 〈 计 算 引 擎 ) 以 及 











Digital Ocean 的 Droplets o 


























使 用 PaaS 模 型 的 供应 商会 让 用 户 通过 他 们 提供 的 工具 ， 将 应 用 部 署 到 云端 的 基础 设施 之 
上 。 提 供 PaaS 服 务 的 例子 有 Heroku、AWS 的 Elastic Beanstalk 以 及 Google 公 司 的 App Engine. 














使 用 SaaS 模 型 的 供应 商会 向 用 户 提 供应 用 服务 。 尺 管 消费 者 当今 使 用 的 绝 大 多 数 服务 都 
可 以 看 作 是 SaaS 服 务 ， 但 是 在 本 书 的 语 境 中 ， 我 们 只 会 把 Heroku 的 Postgres 数据 库 服 务 
(Postgres database service， 它 提供 的 是 基于 云 的 Postgres 服 务 ) 、AWS 的 Relational Database 



































Service 〈 关 系数 据 库 服务 ，RDS) 以 及 Google 公 司 的 Cloud SQL. 〈 云 SQL ) 这 样 的 服务 看 作 是 
SaaS 服 务 。 


在 本 章 中 ， 我 们 将 学 习 如 何 利 用 IaaS 和 PaaS 供 应 商 来 部 署 GoWeb 应 用 。 











本 书 第 7 章 介绍 过 的 简单 Web 服 务 由 代码 清单 10-1 中 的 data.go 和 
代码 清单 10-2 中 的 server .go 这 两 个 文件 组 成 ， 前 者 包含 了 所 有 指 同 数 





据 库 的 连接 和 所 有 对 数据 库 进 行 读 写 的 函数 ， 而 后 者 则 包含 了 main K 
数 和 Web 服 务 的 所 有 处 理 逻 辑 。 





1 
lm- 





代码 清单 10-1 使 用 data.go 访问 数据 库 








package main 


import ( 

"database/sgl" 

_ "github.com/lib/pq" 
) 


var Db *sq1.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user-gwp dbname-gwp password-gwp 
e sslmode-disable") 
if err !- nil ( 
panic(err) 
} 
} 


func retrieve(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = 
w$1", id).Scan(&post.Id, &post.Content, &post.Author) 
return 


} 


func (post *Post) create() (err error) ( 
statement :- "insert into posts (content, author) values ($1, $2) 
wreturning id" 
stmt, err :- Db.Prepare(statement) 


if err != nil { 
return 
} 
defer stmt.Close() 
err - stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


} 


func (post *Post) update() (err error) ( 
_, err = Db.Exec("update posts set content = $2, author = $3 where id = 
w $1", post.Id, post.Content, post.Author) 
return 
} 
func (post *Post) delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 


} 














代码 清单 10-2 ”定义 了 Go Web 服 务 的 server .go 

















package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 

) 


type Post struct ( 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.HandleFunc("/post/", handleRequest) 
server.ListenAndServe() 


} 


func handleRequest(w http.ResponseWriter, r *http.Request) { 
var err error 


switch r.Method { 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err - handleDelete(w, r) 


j 

if err !- nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 

} 


} 


func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err !- nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 
} 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 


} 


func handlePost(w http.ResponseWriter, r *http.Request) (err error) { 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) 
var post Post 
json.Unmarshal(body, &post) 
err - post.create() 


if err != nil { 
return 

} 

w.WriteHeader(200) 

return 


func handlePut(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err != nil { 
return 
j 
post, err :- retrieve(id) 
if err != nil { 
return 
} 


len := r.ContentLength 

body := make([]byte, len) 
r. Body .Read (body) 
json.Unmarshal(body, &post) 
err = post.update() 


if err != nil { 
return 

} 

w.WriteHeader(200) 

return 


} 


func handleDelete(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 


if err != nil { 
return 

} 

post, err := retrieve(id) 

if err != nil { 
return 

} 

err = post.delete() 

if err !- nil { 
return 

} 

w.WriteHeader(200) 

return 








首先 ， 我 们 需要 使 用 以 下 命令 编译 这 段 代 码 : 


go build 


如 果 我 们 把 简单 Web 服 务 的 代码 放 到 一 个 名 为 ws-s 的 目录 里 ， 那 
么 这 个 编译 命令 将 产生 一 个 同名 的 可 执行 二 进 制 文件 。 为 了 部 署 Web 服 
务 ws-s ， 我 们 需要 把 ws-s 文 件 复 制 到 服务 器 里 ， 并 将 其 放置 到 一 个 可 
以 通过 外 部 访问 的 地 方 。 


接着 我 们 只 需要 登录 服务 器 ， 并 在 终端 里 执行 以 下 命令 ， 就 可 以 运 
行 ws-s 这 个 Web 服 务 了 : 


./WS-S 


需要 注意 的 是 ， 因 为 Web 服 务 现在 是 在 前 台 运行 ， 所 以 在 服务 运行 
期 间 ， 我 们 将 无 法 执行 其 他 操作 。 与 此 同时 ， 我 们 也 无 法 简单 地 通过 & 
命令 或 者 bg 命令 在 后 台 运行 这 个 服务 ， 因 为 这 样 做 的 话 ， 一 旦 用 户 登 
出 ，Web 服 务 就 会 被 杀 死 。 





避免 上 述 问题 的 一 种 方法 就 是 使 用 nohup 命令 ， 让 操作 系统 在 用 户 
注销 时 ， 把 发 送 至 Web 服 务 的 HUP (hangup， 挂 起 ) 信号 忽略 掉 : 


nohup ./ws-s & 


执行 上 述 命令 将 导致 Web 服 务 被 放 到 后 台 运 行 ， 并 且 不 用 担心 因 
为 HUP 信和 号 而 被 杀 死 。 以 这 种 方式 启动 的 Web 服 务 仍 会 如 常 地 与 客户 端 
进行 连接 ， 但 现在 的 Web 服务 将 忽略 所 有 挂 起 或 者 退出 信号 。 因 为 这 种 
状态 下 运行 的 Web 服务 在 骨 溃 时 将 不 会 有 任何 提醒 ， 所 以 在 服务 衣 溃 或 
者 服务 器 重启 之 后 ， 用 户 必 须 重 新 登入 系统 并 重启 服务 。 








除 nohup 之 外 ， 持 续 运 行 Web 服 务 的 另 一 种 方法 是 使 用 Upstart 或 者 





systemd 这 样 的 init 守护 进程 : init 进程 是 类 Unix 系 统 在 启动 时 运行 的 
第 一 个 进程 ， 访 进程 由 内 核 负 责 司 动 ， 它 会 一 直 运 行 直 到 系统 关闭 为 
止 ， 并 且 它 还 是 其 他 所 有 进程 直接 或 间接 的 祖先 。 


Upstart 是 由 Ubuntu 创建 的 一 个 基于 事件 的 init 蔡 代 品 ， 尽 管 现在 
systemd 也 越 来 越 受到 大 家 的 青睐 ， 但 考虑 到 这 两 个 工具 都 能 够 完成 本 
节 介 绍 的 工作 ， 并 且 Upstart 的 使 用 方法 相对 来 说 要 更 为 简单 一 些 ， 所 以 
我 们 接 下 来 将 要 学 习 如 何 使 用 Upstart 来 持续 地 运行 Web 服 务 。 


为 了 使 用 Upstart， 用 户 首 先 需 要 创建 一 个 对 应 的 Upstart 任 务 配 置 文 
件 ， 并 将 该 文件 放 到 etc/init 目录 里 面 。 对 简单 Web 服 务 来 说 ， 我 们 
将 创建 代码 清单 10-3 所 示 的 ws .conf 文件 ， 并 将 它 放 到 etc/init 目录 
里 面 。 














代码 清单 10-3 ”简单 Web 服 务 的 Upstart 任 务 配置 文件 

















respawn 
respawn limit 10 5 


setuid sausheong 


setgid sausheong 


exec /go/src/github.com/sausheong/ws-s/ws-s 





这 个 Upstart 任 务 配置 文件 非常 简单 和 直接 。 文 件 中 的 每 个 Upstart 任 
务 都 由 一 个 或 任意 多 个 称 为 节 Cstanzas) 的 命令 块 组 成 。 第 一 节 
respawn 指示 当 任务 失效 (fail) 时 ，Upstart 将 对 其 实施 重新 派生 
(respawn) 或 者 重新 启动 。 第 二 节 respawn limit 10 5 为 respawn 
设置 了 参数 ， 它 指示 Upstart 最 多 内 会 答 试 重新 派生 该 任务 10 次 ， 并 且 每 
次 尝试 之 间 会 有 5 s 的 间隔 ; 在 用 完了 10 次 重新 派生 的 机 会 之 后 ，Upstart 





将 不 再 尝试 重新 派生 该 任务 ， 并 将 该 任务 视 为 已 失效 。 第 三 节 和 第 四 节 
4A Vi Y ar 行进 程 的 用 户 以 及 用 户 组 ， 而 最 后 一 市 则 是 Upstart 在 局 动 任 
务 时 需要 运行 的 可 执行 文件 。 














为 了 局 动 上 述 Upstart 任 务 ， 我 们 需要 在 终端 里 面 执行 以 下 命令 : 


sudo start ws 
ws start/running, process 2011 


这 个 命令 将 触发 Upstart 读 取 /etc/init/ws . conf 任务 配置 文件 并 
局 动 任务 。 本 市 以 管 中 舌 豹 的 方式 ， 快 速 地 了 解 了 如 何 使 用 简单 的 
Upstart 任 务 运 行 一 个 Go Web 应 用 ， 但 是 除 这 里 介绍 的 内 容 之 外 ， 
Upstart 的 任务 配置 文件 还 有 其 他 不 同 的 节 可 供 使 用 ， 并 且 Upstart 的 任务 
也 拥有 多 种 不 同 的 配置 方式 可 以 使 用 ， 不 过 这 些 内 容 不 在 本 书 的 介绍 范 
围 之 内 ， 有 兴趣 的 读者 可 以 自行 通过 互联 网 进行 了 解 。 


为 了 验证 Upstart 是 否 能 够 正确 地 运行 和 管理 ws-s 服务 ， 我 们 可 以 
尝试 在 Upstart 任 务 启动 之 后 ， 杀 死 正在 运行 的 ws-s 服务 : 


ps -ef | grep ws 
sausheo« 2011 1 0 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws-s/ws-s 


sudo kill -6 2011 


ps -ef | grep ws 
sausheo« 2030 1 © 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws-s/ws-s 





注意 看 ， 在 kill 命令 执行 之 前 ，ws-s 进程 的 ID 为 2911 ， 但 是 
在 kill 命令 执行 之 后 ，ws-s 进程 的 ID 变 成 了 2636 一 这 是 因为 
Upstart 在 kill 命令 执行 之 后 ， 察 觉 到 了 ws-s 进程 已 被 关闭 ， 于 是 它 重 


启 了 ws-s 进程 ， 从 而 导致 ws-s 进程 的 ID 发 生 了 变化 。 


最 后 ， 因 为 大 部 分 Web 应 用 都 部 普 在 标准 HITP 端 口 〈 即 80 端 口 ) 
之 上 ， 所 以 读者 在 实际 部 署 时 ， 应 该 将 简单 Web 服 务 代 码 中 的 端口 号 从 
现在 的 8080 改 为 80， 或 者 通过 某 种 机 制 将 8080 妆 口 的 流量 代理 或 者 重 定 
向 到 80 端 口 。 








10.2 ”将 应 用 部 署 到 Heroku 


在 上 一 节 中 ， 我 们 学 习 了 如 何 将 一 个 简单 的 Go Web/l s 5-5 S81 
立 的 服务 器 上 面 ， 以 及 如 何 通过 init 守护 进程 管理 Web 服 务 。 在 本 节 
中 ， 我 们 将 要 学 习 如 何 将 同样 的 web 服务 部 署 到 PaaS 供 应 商 Heroku 上 
面 ， 这 种 部 署 方式 跟 上 一 节 介绍 的 部 单方 式 一 样 简 单 。 








Heroku 人 允许 用 户 部 署 、 运 行 和 管理 使 用 包括 Go 在 内 的 几 种 编程 语 
言 开 发 的 应 用 。 根 据 Heroku 的 定义 ， 一 个 应 用 就 是 由 Heroku 文 持 的 某 
一 种 编程 语言 编写 的 一 系列 源 代 码 ， 以 及 与 这 些 源 代 码 相 关联 的 依赖 关 
系 。 


Heroku 的 预 设 条 件 非常 简单 ， 它 只 要 求 用 户 提 供 以 下 几 样 东西 : 


定义 依赖 关系 的 配置 文件 或 者 相关 机 制 ， 如 Ruby 的 Gemfile 文件 、 
Node.js 的 package.json 文件 或 者 Java 的 pom.xml 文件 ; 
定义 可 执行 文件 的 Procfile 文件 ， 其 中 可 执行 文件 可 以 有 不 止 一 


"se 


Heroku 大 量 地 使 用 命令 行 ， 并 因此 提供 了 一 个 名 为 toolbelt 的 命令 行 





工具 ， 用 于 部 署 、 运 行 和 管理 应 用 。 此 外 ，Heroku 还 需要 通过 Git 将 被 

部 署 的 源码 推送 至 服务 器 。 当 Heroku 平 台 接 收 到 Git 推 送 的 代码 时 ， 它 

会 构建 代码 并 获取 指定 的 依赖 天 系 ， 然 后 将 构建 的 结果 以 及 相应 的 依赖 
关系 组 装 到 一 个 slug 里 面 ， 最 后 在 Heroku 的 dynos 上 运行 这 个 

slug (dynos 是 Heroku 对 隔离 式 、 轻 量 级 、 虚 拟 化 的 Unix 容 器 的 称呼 〉。 





尽管 菜 些 管理 和 配置 工作 可 以 在 之 后 通过 Web 界 面 来 完成 ， 但 
Heroku 最 主要 的 操作 界面 还 是 它 的 命令 行 工具 toolbelt， 因 此 我 们 在 注册 
完 Heroku 之 后 的 第 一 件 事 ， 就 是 访问 https:// toolbelt.heroku.com 下 载 
toolbelt. 


Heroku 是 一 个 非典 型 的 Paas 供 应 丙 ， 人 们 想 要 使 用 Paas 来 部 署 Web 
应 用 的 原因 有 很 多 ， 对 Web 应 用 的 开发 者 来 说 ， 最 主要 的 原因 英 过 于 
PaaS 可 以 让 基础 设施 和 系统 层 变 得 抽象 ， 并 且 不 再 需要 人 工 的 管理 和 干 
预 。 尽 管 PaaSs 在 企业 级 IT 基础 设施 这 样 的 大 规模 生产 环境 中 并 不 少见 ， 
但 它们 对 小 型 公司 和 创业 公司 来 说 却 能 够 提供 极 大 的 方便 ， 并 且 能 够 有 
效 地 减少 这 些 公司 在 基础 设施 方面 的 前 期 投入 。 











在 下 载 完 ioolbelt 之 后 ， 用 户 需要 使 用 注册 账号 时 获得 的 任 据 登入 


Heroku: 


heroku login 
Enter your Heroku credentials. 
Email: «your email» 


Password (typing will be hidden): 
Authentication successful. 





图 10-1 展 示 了 将 简单 Web 服 务 部 团 到 Heroku 的 具体 步 又 。 


为 了 将 简单 Web 应 用 部 署 到 Heroku， 我 们 需要 对 这 个 应 用 的 代码 做 
一 些 细微 的 修改 : 在 当前 的 代码 中 ， 应 用 使 用 的 是 8080 端 口 ， 但 是 在 把 
应 用 部 署 到 Heroku 的 时 候 ， 用 户 是 无 法 控制 应 用 使 用 哪个 端口 的 ， 程 序 
必须 通过 读 取 环 境 变 量 PORT 来 获知 自己 能 够 使 用 的 端口 号 。 为 此 ， 我 
们 需要 将 server .go 文件 中 main 函数 的 代码 从 现在 的 : 


func main() { 
server := http.Servert{ 
Addr: ":8080", 


http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


} 





修改 为 : 


func main() { 
server := http.Server( 
Addr: ":" + os.Getenv("PORT"),// e 


http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


} 








@ 从 环境 变量 中 获取 端口 号 


修改 代码 ， 
使 用 Godep 将 代码 推送 
RR 引入 依赖 关系 创建 Heroku 应 用 至 Heroku 应 用 


图 10-1 将 Web 应 用 部 署 到 Heroku 的 具体 步 又 





以 上 就 是 将 简单 Web 应 用 部 署 到 Heroku 所 需要 做 的 全 部 代码 修改 ， 
其 他 代码 只 要 保留 原样 即 可 。 在 修改 完 代 码 之 后 ， 我 们 接 下 来 要 做 的 束 





是 将 简单 Web 应 用 所 需 的 依赖 关系 告知 Heroku。Heroku 使 用 
godep Chttps://github.com/tools/godep) 来 管理 Go 的 依赖 关系 ，godep 可 
通过 执行 以 下 命令 来 安装 : 


go get github.com/tools/godep 


在 godep 安 装 完毕 之 后 ， 我 们 需要 使 用 它 来 引入 简单 Web 服 务 的 依 
赖 关系 。 为 此 ， 我 们 需要 在 简单 Web 服 务 的 根 目 录 中 执行 以 下 命令 : 


pue E 


这 条 命令 不 仅 会 创建 一 个 名 为 Godeps 的 目录 ， 它 还 会 获取 代码 中 
的 全 部 依赖 关系 ， 并 将 这 些 依赖 关系 的 源 代码 复制 
到 Godeps/_workspace 目录 中 。 除 此 之 外 ， 这 个 命令 还 会 创建 一 个 名 
为 Godeps.Jjson 的 文件 ， 并 在 该 文件 中 列 出 代码 中 的 全 部 依赖 关系 。 
作为 例子 ， 代 码 清 单 10-4 展 示 了 godep 为 简单 Web 服 务 创建 的 
Godeps.json 文件 。 





代码 清单 10-4 Godeps.json 文件 





{ 
"ImportPath": "github.com/sausheong/ws-h", 


"GoVersion": "go1.4.2", 
"Deps": [ 
{ 
"ImportPath": "github.com/lib/pq", 


"Comment": "go1.0-cutoff-31-ga33d605", 
"Rev": "a33d6053e025943d5dc89dfa1f35fe5500618df7" 





因为 我 们 的 简单 Web 服 务 只 需要 依赖 Postgres 数 据 库 驱动 ， 所 以 文 
件 中 只 出 现 了 关于 该 驱动 的 依赖 信息 。 





在 Heroku 上 实施 部 署 需要 做 的 最 后 一 件 事 ， 就 是 定义 一 
个 Procfile 文件 ， 并 使 用 该 文件 去 描述 需要 被 执行 的 可 执行 文件 或 者 
主 函 数 。 人 代码 清单 10-5 展 示 了 简单 Web 服 务 的 Procfile 文件 。 











代码 清单 10-5 Procfile 文件 


整个 文件 非常 简单 ， 只 有 短 短 的 一 行 。 这 个 文件 定义 了 Web 进 程 
与 ws-h 可 执行 二 进 制 文件 之 间 的 关联 ，Heroku 在 完成 应 用 的 构建 工作 
之 后 ， 就 会 执行 ws-h 文件 。 

















准备 工作 一 切 就 绪 之 后 ， 我 们 接 下 来 要 做 的 就 是 将 简单 Web 服 务 的 
代码 推送 至 Heroku。Heroku 人 允许 用 户 通 过 GitHub 集 成 、Dropbox 同 步 、 
Heroku 官 方 提供 的 API 以 及 标准 的 Git 操 作 等 多 种 不 同 的 手段 来 推送 代 
人 码 。 作 为 例子 ， 本 节 接 下 来 将 展示 如 何 使 用 标准 的 Git 操 作 将 简单 Web 服 
务 推送 至 Heroku。 





在 推送 代码 之 前 ， 用 户 首 先 需 要 创建 一 个 Heroku 应 用 : 


heroku create ws-h 


这 条 命令 将 创建 一 个 名 为 ws -h 的 Heroku 应 用 ， 该 应 用 最 终 将 在 地 
址 https://ws-h.herokuapp.com 上 展示 。 需 要 注意 的 是 ， 因 为 本 书 在 这 里 已 
经 使 用 了 ws-h 作为 应 用 的 名 字 ， 所 以 读者 将 无 法 创建 相同 名 字 的 应 








用 。 为 此 ， 读 者 在 创建 应 用 的 时 候 可 以 使 用 其 他 名 字 ， 或 者 在 创建 应 用 
时 去 挥 名 字 参 数 ， 让 Heroku 为 应 用 自动 生成 一 个 随机 的 名 字 : 


heroku create 


heroku create 命令 将 为 我 们 的 简单 Web 服 务 创建 一 个 本 地 的 Git 
代码 库 Crepository) ， 并 在 代码 库 中 添加 远程 Heroku 代 码 库 的 地 址 。 
此 ， 用 户 在 创建 完 Heroku 应 用 之 后 ， 就 可 以 通过 以 下 命令 使 用 Git 将 应 
用 代码 推送 至 Heroku: 


git push heroku master 


因为 Heroku 在 接收 到 用 户 推送 的 代码 之 后 就 会 自动 触发 相应 的 构建 
以 及 部 蜀 操 作 ， 所 以 将 应 用 部 车 到 Heroku 的 工作 到 此 就 可 以 告 一 段落 
了 。 除 上 面 提 到 的 工具 之 外 ，Heroku 还 提供 了 一 系列 非常 棒 的 应 用 管理 
工具 ， 这 些 工具 可 以 对 应 用 进行 性 能 扩展 以 及 版 本 管理 ， 并 且 在 需要 
时 ， 用 户 也 可 以 使 用 Heroku 提 供 的 配置 工具 添加 新 的 服务 ， 有 兴趣 的 读 
者 可 以 目 行 查 阅 Heroku 提 供 的 相关 文档 。 





10.3 ”将 应 用 部 着 到 Google App Engine 


Google App Engine (GAE) 是 男 一 个 流行 的 Go Web H Paas ùi 
平台 。Google 公 司 在 它 的 云 平 台 产 品 套 件 中 包含 了 App Engine (应 用 引 
擎 ) 和 Compute Engine GTI) 等 多 种 服务 ， 其 中 App Engine 为 
PaaS 服 务 ， 而 Compute Engine 则 跟 AWS 的 EC2 和 Digital Ocean 的 Droplets 
一 样 ， 是 一 个 Iaas 服 务 。 使 用 EC2 和 Droplets 这 样 的 服务 跟 使 用 自 有 的 虚 


拟 机 或 者 服务 器 并 没有 太 大 区 别 ， 并 且 我 们 已 经 在 上 一 市 学 习 过 如 何在 
类 似 的 平台 上 进行 部 署 ， 因 此 在 这 一 市 ， 我 们 要 学 习 如 何 使 用 GAE 这 球 
由 Google 公 司 提供 的 强大 的 PaaS 服 务 。 


人 们 选择 使 用 GAE 而 不 是 包括 Heroku 在 内 的 其 他 PaaS 服 务 的 原因 通 
常会 有 好 几 种 ， 但 其 中 最 主要 的 原因 还 是 跟 性 能 和 可 扩展 性 有 关 。GAE 
能 够 让 用 户 构建 出 可 以 根据 负载 自动 进行 性 能 扩展 和 负载 平衡 的 应 用 ， 
并 且 Google 公 司 除 为 GAE 提 供 了 大 量 的 工具 之 外 ， 还 在 GAE 内 部 构建 了 
大 量 的 功能 。 比 如 ，GAE 人 允许 用 户 的 应 用 通过 身份 验证 功能 登录 Google 
账号 ， 并 且 GAE 还 提供 了 发 送 邮件 、 创 建 日 志 、 发 布 和 管理 图 片 等 多 种 
服务 。 除 此 之 外 ，GAE 用 户 还 可 以 非常 简单 直接 地 在 自己 的 应 用 中 集成 
其 他 Google API. 





虽然 GAE 拥 有 如 此 多 的 优点 ， 但 天 下 并 没有 免费 的 午餐 一 一 GAE 在 
拥有 众多 优点 的 同时 ， 也 拥有 不 少 限制 和 缺点 ， 其 中 包括 : 用 户 只 拥有 
对 文件 系统 的 读 权 限 ， 请 求 时 长 不 能 超过 60 s〈 人 否则 GAE 将 强制 杀 死 该 
请 求 )， 无 法 进行 直接 的 网 络 访问 ， 无 法 创建 其 他 类 型 的 系统 调用 ， 等 
和 等。 这些 限制 意味 着 用 户 将 不 能 (至 少 是 无 法 轻易 地 ) 访问 Google 应 用 
环境 沙 箱 Csandbox) 之 外 的 其 他 大 量 服务 。 








图 10-2 展 示 了 在 GAE 上 部 普 Web 应 用 的 大 致 步 又。 


修改 代码 ， 使 用 将 应 用 代码 
Google 提 供 的 库 创建 app.yml 文 件 创建 GAE 应 用 推送 至 GAE 平 台 


图 10-2 ”在 GAE 上 部 署 应 用 的 大 致 步 又 




















跟 其 他 所 有 Google 服 务 一 样 ， 使 用 GAE 也 需要 一 个 Google 账 号 。 跟 


Heroku 大 量 使 用 命令 行 界面 的 做 法 不 同 ， 在 GAE 上， 对 Web 应 用 的 大 部 
分 管理 和 维护 操作 都 是 通过 名 为 Google Developer Console〈 开 发 者 控制 
A) 的 Web 界 面 完成 的 。 虽 然 GAE 也 拥有 与 开发 者 控制 台 具 有 同等 功能 
的 命令 行 接口 ， 但 Google 公 司 的 命令 行 工具 并 没有 像 Heroku 那 样 集成 这 
些 接口 。 图 10-3 展 示 了 Google 开 发 者 控制 台 的 使 用 界面 。 


除了 注册 账号 之 外 ， 使 用 GAE 需 要 做 的 另 一 件 事 就 是 访问 
https://cloud.google.com/appengine/ downloads 下 载 相应 的 SDK (Software 
Development Kit， 软 件 开发 工具 包 ) 。 在 这 个 例子 中 ， 我 们 将 下 载 GAE 
为 Go 语言 提供 的 SDK。 


eoe < I console.developers.google.com/project 
Ca ak St EN respiro a $299.49 and 54 days P r^] 2n 8 
Columns ~ $ 
Project Name Project ID Requests Errors Charges 
ws-g "d 8 


'rojects pending deletior 








图 10-3 ”使 用 Google 开 发 者 控制 台 创 建 GAE Web 应 用 





有 GAE 与 其 他 Google 服 务 











| GAE 和 Google Cloud SQL 这 样 的 Google 服 务 并 不 是 免费 的 。Google 公 司 会 为 新 注册 的 用 





户 提供 60 天 的 试用 期 以 及 价值 300 美 元 的 试用 额度 ， 因 此 读者 应 该 可 以 免费 实践 本 节 介绍 的 内 















































容 ， 但 是 当 试 用 期 到 期 或 者 试用 额度 耗 尺 时， 读者 就 需要 付费 才能 继续 使 用 这 些 服务 了 。 

















在 安装 完 SDK 之 后 ， 我 们 接 下 来 要 做 的 是 对 GAE 的 数据 存储 
(datastore) 进行 配置 。 正 如 前 所 说 ，Google 公 司 对 直接 的 网 络 访问 有 
严格 的 限制 ， 用 户 是 无 法 直接 连接 外 部 的 PostgreSQL 服 务 嚣 的。 为 此 ， 
在 这 一 节 中 ， 我 们 将 使 用 Google 公 司 提供 的 Google Cloud SQL 服务 来 代 
fiPostgreSQL. Google Cloud SQL 是 一 个 基于 MySQL 的 云端 数据 库 服 
务 ， 用 户 可 以 通过 cloudsql 包 直 接 在 GAE 中 使 用 该 服务 。 





为 了 使 用 Google Cloud SQL， 我 们 需要 移 通 过 开发 者 控制 合 创建 一 
个 数据 库 实例 ， 具 体 步 又 如 图 10-4 所 示 。 用 户 首 先 需 要 在 控制 台 上 点 击 
自己 创建 的 项 目 〈《 在 这 个 例子 中 ， 我 创建 的 项 目 名 为 ws-g-1234 ) ， 接 
着 在 左 侧 的 导航 面板 中 点 击 “Storage”( 存 储 ) ， 然 后 再 选择 其 中 
的 “Cloud SQL”， 从 而 进入 Cloud SQL 的 设置 页 面 。 在 点 击 “New 
Instance”(〈 新 实例 ) 按钮 之 后 ， 用 户 将 会 看 到 一 些 与 创建 数据 库 实例 有 
关 的 选项 。 这 些 选项 中 的 大 部 分 已 经 预先 设置 好 了 ， 需 要 改动 的 地 方 不 
多 ， 我 们 唯一 要 做 的 就 是 将 “Preferred location" (首选 位 置 ) 选项 设置 
为 “Follow App Engine App" CE App Engine 的 应 用 保持 一 致 }; ， 并 让 项 
目的 应 用 ID 保持 默认 值 不 变 。 在 进行 了 上 述 设置 之 后 ， 我 们 的 GAE 应 用 
就 能 够 正常 访问 数据 库 实 例 了 。 





需要 注意 的 是 ， 因 为 Google 公 司 默认 会 为 用 户 的 数据 库 实 例 提供 一 
个 免费 的 IPv6 地 址 ， 但 是 却 不 会 提供 IPv4 地 址 ， 所 以 如 果 你 的 加 面 计算 
机 、 移 动 电脑 、 服 务 器 或 者 你 正在 使 用 的 网 络 供应 商 并 没有 使 用 IPv6 连 
接 ， 那 么 你 还 需要 花 一 点 额外 的 钱 去 获取 一 个 IPv4 地 址 ， 并 将 这 个 地 址 


添加 到 设置 页 面 。 


3. 选择 Follow App Engine App。 






eoo console.developers.google.com/project/ws-g-1234/sql/create : [| J 
Cx ws-g * jpgrade you snt. Only $299.49 and 54 days remain in your free trial e^ 
0025 
Compute 
Preferred location App Engine application ID 
App Engine 
Follow App Engine App > ws-g-1234 
Backups 
V/ Enable backups 12:00 PM — 4:00 PM 
Binary log (requires backups) 
Activation policy 
€ On Demand 
Always On 
Compute Engine Never 


Container Engine 


Networking File system replication 


€ Synchronous 
Storage 


Cl table 
oud Bigtable Asynchronous 
Cloud Datastore 


Cloud SQL IPv4 address 





Cloud Storage Assign an IPv4 address to my Cloud SQL instance 
Big Data i 
1. 点 击 Storage， 2. 选择 Cloud SQL。 4. 设置 IPv4 IP 地 址 。 


展示 存储 菜单 。 





图 10-4 通过 开发 者 控制 台 创 建 一 个 Google Cloud SQL 数据 库 实例 





除 以 上 提 到 的 少数 几 个 选项 之 外 ， 其 他 选项 只 需要 保留 默认 即 可 。 
在 最 后 ， 用 户 只 需要 为 自己 的 实例 设置 一 个 名 字 ， 一 切 就 大 功 告 成 了 。 


也 许 你 已 经 预料 到 了 ， 因 为 GAE 平 台 是 如 此 地 别具一格 ， 所 以 为 了 
将 Web 应 用 部 署 到 这 个 平台 上 ， 对 代码 的 修改 自然 也 变 得 无 法 避免 了 。 
下 面 从 高 层次 的 角度 列 出 了 将 简单 Web 服务 部 敬 到 GAE 所 需要 做 的 一 


些 事 情 : 


。 修改 包 名 ， 不 再 使 用 main 作为 包 名 ; 


e FER main PK ZI; 

。 把 处 理 器 的 注册 语句 移 到 init 函数 里 面 ; 

。 使 用 MySQL 数 据 库 驱 动 代 蔡 PostgreSQL 数 据 库 驱 动 ; 
把 SQL 查 询 修 改 为 MySQL 格 式 。 


因为 GAE 将 接管 被 部 署 的 整个 应 用 ， 所 以 用 户 将 无 法 控制 应 用 何 时 
被 启动 或 者 运行 在 哪个 端口 之 上 。 实 际 上 ， 用 户 编写 的 将 不 再 是 一 个 独 
立 的 应 用 ， 而 是 一 个 部 署 在 GAE 上 的 包 。 这 样 导致 的 结果 是 ， 用 户 将 不 
能 再 使 用 main 这 个 为 独立 的 Go 程序 预 留 的 包 名 ， 而 是 要 将 包 名 修改 
为 main 以 外 的 其 他 名 字 。 


接 下 来 ， 用 户 还 需要 移 除 程 序 中 的 main 函数 ， 并 将 该 函数 中 的 代 
码 移 到 init 函数 。 对 简单 Web 服 务 来 说 ， 我 们 需要 将 原来 的 main K 
数 : 
func main() { 


server := http.Servert{ 
Addr: ":8080", 


http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


} 





修改 为 以 下 init 函数 : 


func init() { 
http.HandleFunc("/post/", handlePost) 
} 





注意 ， 在 新 的 init 函数 里 ， 原 本 用 于 指定 服务 器 地 址 以 及 端口 号 





的 代码 己 经 消失 ， 同 样 消失 的 还 有 用 于 局 动 Web 服 务 器 的 相关 代码 。 


考虑 到 我 们 还 需要 将 简单 Web 服 务 使 用 的 数据 库 驱 动 从 PostgreSQL 
切换 至 MySQL， 因 此 我 们 需要 在 data.go 中 导入 MySQL 数 据 库 驱动 ， 
并 设置 正确 的 数据 连接 字符 串 : 
import ( 


"database/sgl" 
_ "github.com/ziutek/mymysql/godrv" 


) 
func init() { 

var err error 

Db, err = sql.Open("mymysql", "cloudsql:«app ID»:«instance name»*«databa 


se 
ename»/«user name»/«password»") 
if err !- nil { 
panic(err) 
} 
} 





除了 上 述 修改 之 外 ， 我 们 还 需要 将 相应 的 SQL 查询 修 改 为 MySQL 格 
式 。 尽 管 这 两 种 数据 库 使 用 的 语法 非常 相似 ， 但 并 不 完全 相同 ， 所 以 程 
序 是 无 法 在 不 做 修改 的 情况 下 直接 运行 的 。 比 如 ， 对 于 以 下 代码 中 加 粗 
显示 的 SQL 碍 询 语句 : 





func retrieve(id int) (post Post, err error) ( 
post = Posti) 
err - Db.QueryRow("select id, content, author from posts where id - 


$1 


",; id).Scan(&post.Id, &post.Content, &post.Author) 
return 


} 





我 们 将 不 再 使 用 诸如 $1 、$2 这 样 的 标识 ， 而 是 使 用 ?来 表示 被 蔡 
换 的 变量 ， 就 像 这 样 : 





func retrieve(id int) (post Post, err error) ( 
post = Posti) 
err - Db.QueryRow("select id, content, author from posts where id - ?", 


e id).Scan(&post.Id, &post.Content, &post.Author) e 
return 





O 根据 MySQL 的 查询 格式 ， 将 原来 的 $n 标识 修改 为 ?标识 


在 对 代码 做 完 必要 的 修改 之 后 ， 我 们 接 下 来 还 要 创建 一 个 对 应 用 进 
行 描述 的 app.yaml 文件 ， 如 代码 清单 10-6 所 示 。 

















代码 清单 10-6 ”用 于 GAE 部 署 的 app.yaml 文 件 








application: ws-g-1234 
version: 1 

runtime: go 

api version: gol 


handlers: 
- url: /.* 


script: go app 








这 个 文件 非 党 简单， 一目了然， 该 者 在 进行 测试 时 ， 唯 一 需要 做 的 
就 是 在 这 个 文件 中 修改 应 用 的 名 字 ， 然 后 一 切 就 大 功 告 成 了 ! 以 上 就 是 
将 简单 Web 服 务 部 普 到 GAE 上 所 需要 做 的 全 部 工作 ， 接 下 来 ， 是 时 候 对 
这 个 将 要 运行 在 GAE 之 上 的 简单 Web 服 务 做 一 些 测 试 了 ! 








因为 我 们 在 前 面 对 应 用 做 了 大 量 的 修改 ， 所 以 可 能 会 有 读者 觉得 自 
己 已 经 无 法 在 本 地 的 机 器 上 运行 这 个 应 用 了 ， 不 过 这 种 担心 是 不 必要 的 
一 一 开发 者 只 需要 使 用 Google 公 司 提供 的 GAE SDK， 就 可 以 在 本 地 运 
行 自己 的 GAE 应 用 了 。 


在 按照 下 载 页 面 提 供 的 指示 安装 了 GAE SDK 之 后 ， 我 们 只 需要 在 
应 用 的 根 目 录 下 使 用 终端 执行 以 下 命令 ， 束 可 以 运行 目 己 的 GAE WebM 
用 了 : 


GAE SDK 提 供 了 在 本 地 运行 GAE 应 用 所 需 的 环境 ， 从 而 使 用 户 可 
以 在 本 地 测试 自己 的 应 用 。 除 此 之 外 ，GAE SDK 还 提供 了 一 个 本 地 运 
行 的 管理 网 站 (admin site》， 用 户 只 雷 访 问 http://localhost:8000/， 束 可 
以 通过 该 网 站 检视 自己 编写 的 代码 。 遗 憾 的 是 ， 在 撰写 本 书 的 时 候 ， 开 
发 环境 还 不 文 持 Cloud SQL， 上 所 以 我 们 还 无 法 直接 在 本 地 测试 简单 Web 
服务 。 解 决 这 个 问题 的 一 种 方法 是 在 本 地 使 用 MySQL 服 务 器 进行 测 
试 ， 然 后 在 生产 环境 中 继续 使 用 Cloud SQL 数据 库 。 





在 确保 应 用 一 切 正常 之 后 ， 用 户 就 可 以 通过 执行 以 下 命令 ， 将 应 用 
部 署 到 Google 公 司 的 服务 器 上 了 : 


goapp deploy 


在 执行 以 上 命令 之 后 ，SDK 将 把 应 用 的 代码 推送 到 Google 公 司 的 服 
务 器 ， 然 后 由 服务 器 对 其 进行 编译 和 部 署 。 如 果 一 切 正常 ， 被 推送 的 应 
用 将 如 期 地 出 现在 互联 网 上 。 比 如 ， 我 们 可 以 通过 http://ws-g- 


1234.appspot.comy/ 访 问 名 为 ws-g-1234 的 应 用 。 


为 了 测试 这 个 刚刚 部 署 完毕 的 简单 Web 服 务 ， 我 们 可 以 使 用 以 下 命 
令 ， 让 curl 回 服务 器 发 送 一 个 创建 数据 库 记 录 的 POST 请 求 : 


curl -i -X POST -H "Content-Type: application/json" -d '("content":"My fir 
st 


post","author":"Sau Sheong"j' http://ws-g-1234.appspot.com/post/ 
HTTP/1.1 200 OK 
Content-Type: text/html; charset-utf-8 


Date: Sat, 01 Aug 2015 06:46:59 GMT 
Server: Google Frontend 
Content-Length: 6 
Alternate-Protocol: 80:quic,p-0 





现在 再 次 使 用 curl 去 获取 刚刚 创建 的 数据 库 记 录 : 


curl -i -X GET http://ws-g-1234.appspot.com/post/1 
HTTP/1.1 200 OK 

Content-Type: application/json 

Date: Sat, 01 Aug 2015 06:44:29 GMT 

Server: Google Frontend 

Content-Length: 69 


Alternate-Protocol: 80:quic,p-0 
{ 


"id": 1, 
"content": "My first post", 
"author": "Sau Sheong" 





GAE 非 常 强大 ， 它 拥有 许 许多 多 的 功能 ， 这 些 功 能 可 以 帮助 开发 者 
在 互联 网 上 创建 和 部 署 可 扩展 的 Web 应 用 ， 但 因为 GAE 是 Google 公 司 开 
发 的 平台 ， 所 以 如 果 用 户 想 要 使 用 这 个 平台 ， 就 必须 遵守 这 个 平台 的 规 
则 。 








10.4 将 应 用 部 署 到 Docker 


前 一 节 简 单 地 介绍 过 Docker， 讨 论 了 如 何 将 Go Web 应 用 封装 为 
Docker 容 堪 并 将 其 推送 至 可 用 的 Docker 托 管 服务 上 ， 而 在 本 节 中 ， 我 们 
将 会 更 加 完整 地 学 习 Docker 的 部 普 方 法 ， 并 研究 如 何 将 简单 Go Web 服 
务 部 普 到 本 地 Docker 箱 主机 以 及 云端 的 Docker 宿 主机 之 上 。 


10.4.1 什么 是 Docker 


Docker 是 一 个 非常 了 不 起 的 项 目 ，PaaS 公 司 dotCloud 最 初 在 2013 年 
发 布 了 这 个 开源 项 目 ， 之 后 无 论 是 大 型 公司 还 是 小 型 公司 ， 都 被 这 一 项 
目 震撼 了 。Google、AWS 以 及 微软 这 样 的 技术 公司 都 在 拥抱 Docker， 
AWS 拥 有 EC2 Container Service (RARI) ，Google 提 供 了 Google 
Container Engine (容器 引擎 ) Digital Ocean、Rackspace 甚 至 IBM 等 众 
多 云 供应 商 也 纷纷 加 入 了 文 持 Docker 的 行列 当中 。 除 此 之 外 ， 像 BBC、 
ING 这 样 的 银行 以 及 高 盛 这 样 的 传统 公司 也 开始 在 内 部 答 试 使 用 
Docker。 


一 言 以 蔽 之，Docker 就 是 在 容器 中 构建 、 友 布 和 运行 应 用 的 一 个 开 
放 平 台 。 容 器 并 不 是 一 项 新 技术 一 一 它 在 Unix 初 期 就 已 经 出 现 ，Docker 
最 初 基 于 Linux 的 容器 就 是 在 2008 年 引入 的 。Heroku 的 dynos 同 样 也 是 一 
种 容器 。 











如 图 10-5 所 示 ， 容 器 与 虚拟 机 的 不 同 之 处 在 于 ， 虚 拟 机 模拟 的 是 包 
括 操作 系统 在 内 的 整个 计算 机 系统 ， 而 容器 只 提供 操作 系统 级 别 的 虚拟 
化 ， 并 将 计算 机 资源 划分 给 多 个 独立 的 用 户 空间 实例 使 用 。 这 两 种 虚拟 
方式 的 差异 导致 容器 对 资源 的 需求 比 虚 拟 机 要 少 得 多 ， 并 且 容 器 的 启动 


速度 和 部 署 速度 也 比 虚 拟 机 快 得 多 。 


虚拟 机 : 模拟 包括 操作 系统 容器 : 提供 操作 系统 级 别 的 虚拟 化 ， 
在 内 的 整个 计算 机 系统 并 将 资源 划分 给 多 个 用 户 空间 实例 


客户 操作 系统 || 客户 操作 系统 


T -------.---2--2-2---. 








图 10-5 ”容器 与 虚拟 机 的 不 同 之 处 在 于 ， 容 器 提供 的 是 操作 系统 级 别 的 虚拟 化 ， 并 且 容 器 可 以 
将 资源 划分 给 多 个 独立 的 用 户 空 间 实例 
Docker 实 质 上 就 是 一 种 管理 容器 的 软件 ， 它 的 存在 使 开发 者 可 以 更 
为 简单 地 使 用 容器 。 除 Docker 之 外 ， 市 面 上 还 存在 着 chroot、Linux 
containers (LXC) 、Solaris Zones、CoreOS 和 ]mctfy 等 一 系列 同类 软 
件 ， 但 Docker 是 其 中 名 声 最 显赫 的 一 球 。 


10.4.2 ”安装 Docker 


Docker 目 前 只 能 在 基于 Linux 的 系统 上 工作 ， 但 它 也 提供 了 一 些 变 
通 的 方法 ， 使 OS X 用 户 和 Windows 用 户 也 能 够 在 自己 的 系统 上 使 用 
Docker 的 开发 工具 。 为 了 安装 Docker， 用 户 需 要 访问 


https://docs.docker.com/engine/installation， 然 后 根据 自己 的 系统 以 及 想 
要 使 用 的 Docker 版 本 ， 照 说 明 安 装 。 对 于 Ubuntu Server 14.04， 我 们 
可 以 通过 执行 以 下 这 个 简单 的 命令 来 安装 Docker: 


wget -qO- https://get.docker.com/ | sh 


在 安装 Docker 之 后 ， 我 们 可 以 通过 执行 以 下 这 条 命令 来 确认 Docker 
是 否 已 经 安装 成 功 : 


sudo docker run hello-world 


这 条 命令 会 从 远程 代码 库 中 拉 取 hello-world 镜像 ， 并 作为 本 地 
这 个 镜像 。 


D 
Bu 
(pi 
十 
ox 


10.4.3 ”Docker 的 概念 与 组 件 


如 图 10-6 所 示 ，Docker 引 警 (简称 Docker) 包含 多 个 组 件 。 刚 才 在 
测试 Docker 安 装 是 否 成 功 时 ， 我 们 束 用 到 了 第 一 个 组 件 Docker 客 户 端 ， 
它 就 是 用 户 在 与 Docker 守 护 进 程 交互 时 所 使 用 的 命令 行 接口 。 








í 


Docker 宇 护 进程 


DockerZt2& 


Docker € 


Dha- 


Docker 镜 像 Dockerfile 


























图 10-6 ”Docker 引 擎 由 Docker 客 户 端 、Docker 守护 进程 以 及 不 同 的 Docker 容 器 组 成 ， 这 些 容器 
为 Docker 镑 像 的 实例 。Docker 镜 像 可 以 通过 Dockerfile 创 建 ， 并 且 镜 像 还 能 够 存储 在 Docker 注 册 
中 心 Cregisty) 中 























Docker 守 护 进程 运行 在 宿主 操作 系统 (host OS) 之 上 ， 该 进程 会 
对 客户 端 发送 的 服务 请 求 进行 应 答 ， 并 对 容器 进行 管理 。 


Docker 容 器 〈 简 称 容器 ) 是 对 运行 特定 应 用 所 需 的 全 部 程序 〈 包 括 
操作 系统 在 内 ) 的 一 种 轻 量 级 虚拟 化 。 轻 量 级 容器 会 让 应 用 以 及 与 之 相 
关联 的 其 他 程序 认为 自己 独占 了 整个 操作 系统 以 及 所 有 便 件 ， 但 是 实际 
上 并 非 如 此 ， 多 个 应 用 共享 同一 宿主 操作 系统 。 





Docker 容 器 都 基于 Docker 镜 像 构建 ， 后 者 是 辅助 容器 进行 局 动 的 只 
读 模 板 ， 所 有 容器 都 需要 通过 镜像 启动 。 有 好 几 种 不 同 的 方法 可 以 创建 
Docker 镜 人像， 其 中 一 种 就 是 在 一 个 名 为 Dockerfile 的 文件 里 包含 一 系列 


指令 。 











Docker 镜 像 既 可 以 以 本 地 形式 存储 在 运行 着 Docker 守 护 进程 的 机 器 
上 《也 就 是 Docker 的 宿主 机 之 上 ) ， 也 可 以 被 托管 至 名 为 Docker 注 册 中 
心 的 Docker 镜 像 资源 库 里 面 。 用 户 既 可 以 使 用 自己 的 私有 Docker 注 册 中 
心 ， 也 可 以 使 用 Docker Hub (https://hub.docker.com/)〉 作为 自己 的 
registy。Docker Hub 同 时 提供 公开 和 私有 的 Docker 镜 像 ， 但 私有 的 
Docker 镜 像 需要 付费 才能 使 用 。 


如 果 用 户 是 在 类 似 Ubuntu 这 样 的 Linux 系 统 上 安装 Docker， 那 么 
Docker 守 护 进 程 和 和 Docker 客 户 端 将 被 安装 到 同一 机 器 里 面 。 但 如 果 用 户 
是 在 OS X 和 Windows 这 样 的 系统 上 安装 Docker， 那 么 Docker 只 会 把 客户 


问安 闭 在 操作 系统 里 面 ， 而 守护 进程 则 会 被 安装 到 其 他 地 方 ， 通 利 会 是 
一 个 运行 在 该 系统 之 上 的 虚拟 机 里 面 。 这 种 情况 的 一 个 例子 是 ， 在 OS 
X 上 安装 Docker 时 ，Docker 客 户 端 将 被 安装 到 OS X 里 面 ， 而 Docker 守 护 
进程 则 会 被 安装 到 VirtualBox〔 一 蒜 基 于 x86 架 构 的 虚拟 机 监视 器 〉 的 一 
个 虚拟 机 里 面 。 


在 此 之 后 ， 用 户 只 需要 通过 Docker 镜 像 来 运行 Docker 容 器 ， 并 将 其 
运行 在 Docker 答 主 之 上 就 可 以 了 。 
在 对 Docker 有 了 一 个 大 体 的 了 解 之 后 ， 我 们 是 时 候 来 学 习 如 何 将 


Web 应 用 部 署 到 Docker 里 面 了 。 接 下 来 的 一 节 将 继续 使 用 前 面 展示 过 的 
简单 Web 服 务 作为 例子 ， 演 示 如 何 将 Web 应 用 部 署 到 Docker 容 峰 。 


10.4.4 Docker 化 一 个 Go Web 应 用 


尽管 Docker 使 用 了 那么 多 的 技术 ， 但 Docker 化 一 个 Go Web 应 用 却 
一 点 也 不 困难 。 因 为 Web 服 务 拥有 对 整个 容器 的 完整 访问 权限 ， 所 以 我 
们 不 需要 对 服务 的 代码 做 任何 修改 ， 只 要 使 用 Docker 并 进行 相应 的 配置 
就 可 以 了 。 作 为 例子 ， 图 10-7 从 高 层次 的 角度 展示 了 将 一 个 web 应 用 
Docker 化 并 部 署 到 本 地 以 及 云端 的 具体 步骤 。 


在 本 节 中 ， 我 们 将 使 用 ws-d 作为 web 服务 的 名 字 。 部 署 的 第 一 步 
是 在 应 用 程序 的 根 目 录 中 创建 一 个 代码 清单 10-7 所 示 的 Dockerfile 文 件 。 


) 创建 ) 使 用 Dockerfile \\ 根据 Docker 在 云端 创建 连接 远程 NN 在 远程 宿主 中 \\\ 在 远程 宿主 中 
Dockerfile 构 Docker 宿 主 Docker 宿 主 构建 Docker 镜 像 / /启动 Docker 容 器 
| | 
| 


部 署 到 本 地 服务 器 部 署 到 云端 














图 10-7 将 Go Web 应 用 Docker 化 并 部 署 到 本 地 以 及 云端 的 具体 步 又 

















代码 清单 10-7 简单 Web 服 务 的 Dockerfile 文 件 








FROM golang @ 


ADD . /go/src/github.com/sausheong/ws-d @ 
WORKDIR /go/src/github.com/sausheong/ws -d 
RUN go get github.com/lib/pq e 


RUN go install github.com/sausheong/ws -d 


ENTRYPOINT /go/bin/ws-d e 


EXPOSE 8080 e 





@ 使 用 一 个 安装 了 Go 并 且 将 GOPATH 设置 为 /go 的 Debian 镜像 作 
为 容器 的 起 点 


O 把 本 地 的 包 文 件 复 制 到 容器 的 工作 空间 里 面 

O 在 容器 内 部 构建 ws-d 命令 

O 把 ws-d 命令 设置 为 随 容器 启动 

Q 注 明 该 服务 监听 的 端口 号 为 8080 

这 个 Dockerfile 文 件 的 第 一 行 告诉 Docker 使 用 golang 镜像 启动 ， 这 
是 一 个 安装 了 最 新 版 Go 并 将 工作 空间 设置 为 /go 的 Debian 镜 像 。 之 后 的 
两 行 会 将 当前 目录 中 的 本 地 代码 复制 到 容 右 中 ， 并 设置 相应 的 工作 目 
录 。 在 此 之 后 ， 文 件 使 用 RUN 命令 指示 Docker 获 取 PostgreSQL 张 动 并 构 
建 Web 服 务 的 代码 ， 然 后 将 可 执行 的 三 进 制 文件 放置 到 /go/bin 目录 


中 。 在 此 之 后 ， 文 件 使 用 ENTRYPOINT 命令 指示 Docker 将 /go/bin/ws- 
d 设置 为 随 容 嚣 启动。 最后， 文件 使 用 EXPOSE 命令 指示 容器 将 8080 端 











口 暴露 给 其 他 容器 。 需 要 注意 的 是 ， 这 个 EXPOSE 命令 只 会 对 同一 宿主 
内 的 其 他 容器 打开 8080 端 口 ， 但 它 并 不 会 对 外 开放 8080 端 口 。 


在 编写 好 Dockerfile 文 件 之 后 ， 我 们 就 可 以 使 用 以 下 命令 来 构建 镜 
像 了 : 


docker build -t ws-d . 


这 条 命令 将 执行 Dockerfile 文 件 ， 并 根据 文件 中 的 指示 构建 一 个 本 
地 镜像 。 如 果 一 切 顺 利 ， 那 么 在 这 条 命令 执行 完毕 之 后 ， 用 户 应 该 可 以 
通过 docker images 命令 看 到 新 鲜 出 炉 的 镜像 文件 : 


REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 
ws-d latest 65e8437fce6b 10 minutes ago 534.7 MB 


在 成 功 创建 镜像 之 后 ， 我 们 就 可 以 通过 运行 镜像 来 创建 和 司 动容 器 
f: 


docker run --publish 80:8080 --name simple web service --rm ws-d 





这 条 命令 会 通过 ws-d 镜像 创建 出 一 个 名 为 simple_web_service 
的 容器 。--publish86:8688 标 志 打开 HTTP 端 口 80 并 将 其 映射 至 前 面 
通过 EXPOSE 命令 暴露 的 8080 端 口 ， 而 -rm 标志 则 指示 Docker 在 容器 已 
经 存在 的 情况 下 ， 先 移 除 已 有 的 容器 ， 然 后 再 创建 并 启动 新 容器 。 如 果 
不 设置 --rm 标志 ， 那 么 Docker 在 容器 已 经 存在 的 情况 下 将 保留 已 有 的 
容器 ， 并 直接 启动 该 容器 ， 而 不 是 创建 并 启动 新 容器 。 为 了 确认 容器 是 
否 已 经 启动 ， 我 们 可 以 执行 以 下 命令 : 





M 
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列表 当中 : 


CONTAINER ID IMAGE ... PORTS NAMES 


eeb674e289a4 ws-d ... 0.0.0.0:80-»8080/tcp simple web service 





因为 页 面 宽度 的 限制 ， 这 里 忽略 了 docker ps 命令 输出 的 某 些 列 ， 
但 这 里 展示 的 信息 已 经 足以 表明 我 们 的 容器 现在 已 经 正常 地 运行 在 本 地 
的 Docker 答 主 之 上 了 。 跟 之 前 一 样 ， 我 们 可 以 通过 curl 命令 回 服务 器 
发 送 一 个 POST 请 求 ， 创 建 一 条 记录 : 


curl -i -X POST -H "Content-Type: application/json" -d '("content":"My fir 
st 

wepost","author":"Sau Sheong"}' http://127.0.0.1/post/ 

HTTP/1.1 200 OK 

Content-Type: text/html; charset-utf-8 

Date: Sat, 01 Aug 2015 06:46:59 GMT 

Server: Google Frontend 

Content-Length: 6 

Alternate-Protocol: 80:quic,p-0 





现在 ， 通 过 curl 命 令 获取 之 前 创建 的 记录 : 





curl -i -X GET http://127.0.0.1/post/1 
HTTP/1.1 200 OK 
Content-Type: application/json 
Date: Sat, 01 Aug 2015 06:44:29 GMT 
Server: Google Frontend 
Content-Length: 69 
Alternate-Protocol: 80:quic,p-0 
{ 

"id": 1, 

"content": "My first post", 


"author": "Sau Sheong" 


} 


10.4.5 将 Docker 容 器 推送 至 互联 网 


把 简单 Web 服 务 Docker 化 为 容器 上 听 起 来 是 一 件 非 常 棒 的 事情 ， 但 这 
个 容器 现在 还 只 是 运行 在 本 地 宿主 上 ， 而 我 们 真正 想 要 做 的 是 把 容器 放 
到 互联 网 上 运行 。 有 几 种 不 同 的 方法 可 以 把 Docker 容 器 部 署 到 远程 宿主 
上 运行 ， 目 前 来 说 ， 最 简单 的 一 种 方法 就 是 使 用 Docker 机 器 了 。 














Docker 机 器 (machine〉 是 一 个 命令 行 接口 ， 它 允许 用 户 在 本 地 以 
及 云端 创建 公开 或 者 私有 的 Docker 和 宿主 。 在 编写 本 书 时 ，Docker 机 器 文 
持 包 括 AWS、Digital Ocean, Google Compute Engine. IBM Softlayer、 
Microsoft Azure、Rackspace、Exoscale 和 VMWare vCloud Air 在 内 的 公有 
JEMA; 与 此 同时 ，Docker 机 器 也 文 持 在 私有 云 供应 丙 以 及 运行 着 
OpenStack、VMWare 或 者 Microsoft Hyper-V 的 云 供应 商 上 创建 宿主 。 








Docker 机 器 并 不 会 与 Docker 本 壬 一 同 被 安装 ， 而 需要 单独 安装 。 用 
户 可 以 通过 克隆 代码 库 https://github.com/docker/machine 或 者 从 
https://docs.docker.com/machine/install-machine/ 下 载 相应 平台 的 二 进 制 包 
来 安装 Docker 机 器 。 比 如 ， 使 用 Linux 的 用 户 就 可 以 通过 以 下 命令 来 获 
得 Docker 机 器 的 二 进 制 包 : 


curl -L https://github.com/docker/machine/releases/download/v0.3.0/docker- 


wmachine linux-amd64 /usr/local/bin/docker-machine 








在 下 载 完 二 进 制 包 之 后 ， 用 户 还 需要 执行 以 下 命令 将 二 进 制 包 变 成 
可 执行 文件 : 


chmod +x /usr/local/bin/docker-machine 


在 下 载 完 Docker 机 器 并 将 它 变 成 可 执行 文件 之 后 ， 就 可 以 在 
Docker 机 器 文 持 的 云端 上 创建 Docker 和 宿主 了 。 要 做 到 这 一 点 ， 其 中 最 为 
轻松 的 一 种 办 法 就 是 使 用 Digital Ocean. Digital Ocean — Afi 用 服 
务 器 (virtual private server, VPS) 供应 商 ， 它 的 服务 以 易于 使 用 以 及 价 
格 实惠 而 著称 (VPS 是 供应 商 以 服务 形式 销售 的 虚拟 机 〉 。Digital 
Ocean 在 2015 年 5 月 成 为 了 仅 次 于 AWS 的 世界 第 二 大 Web 服 务 器 托管 公 
n]. 








为 了 在 Digital Ocean 上 创建 Docker 宿 主 ， 我 们 需要 先 申请 
Digital Ocean 账号 ， 并 在 拥有 账号 之 后 ， 访 问 Digital Ocean 
的 “Applications & APP? 〈 应 用 与 API) 页 面 https:/cloud.digitalocean.comy/ 


settings/applications 。 


图 10-8 展 示 了 “Applications & AP 页 面 的 样子 ， 该 页 面 中 包含 了 一 
个 “Generate new token” (ŒI SIO 按钮 ， 我 们 可 以 通过 点 击 这 个 按 
钮 来 生成 一 个 新 的 令 牌 。 生 成 令 牌 时 首先 要 做 的 就 是 输入 一 个 名 字 ， 并 
勾 选 其 中 的 “Write”( 写 入 ) 复 选 框 ， 然 后 点 击 “Generate new token” (Œ 
BAR 按钮 。 这 样 一 来 ， 你 就 会 拥有 一 个 由 用 户 名 和 密码 混合 而 成 的 
个 人 访问 令 牌 ， 这 个 令 牌 可 以 用 于 进行 API 吴 份 验证 。 需 要 注意 的 是 ， 
令 牌 只 会 在 生成 时 出 现 一 次 ， 之 后 便 不 再 出 现 ， 因 此 用 户 需 要 把 这 个 令 
牌 存 储 到 安全 的 地 方 。 
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图 10-8 在 Digital Ocean 上 生成 个 人 访问 令 牌 非常 简单 ， 只 需要 点 击 “Generate new token" B] nf 





为 了 使 用 Docker 机 器 在 Digital Ocean 上 创建 Docker 和 宿主 ， 我 们 需要 
在 控制 全 执行 以 下 命令 : 


docker-machine create --driver digitalocean --digitalocean-access-token «t 
okenwsd 

Creating CA: /home/sausheong/.docker/machine/certs/ca.pem 

Creating client certificate: /home/sausheong/.docker/machine/certs/cert.pe 


m 
Creating SSH key... 

Creating Digital Ocean droplet... 

To see how to connect Docker to this machine, run: docker-machine env wsd 
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以 我 们 需要 对 它 进行 调整 ， 让 它 改 为 连接 Digital Ocean 上 aa 
主 。Docker 机 器 返回 的 结果 提示 我 们 应 该 如 何 做 到 这 一 点 。 简 单 来 说 ， 
我 们 需要 执行 以 下 命令 : 





docker-machine env wsd 

export DOCKER TLS VERIFY-"1" 

export DOCKER HOST-"tcp://104.236.0.57:2376" 

export DOCKER CERT PATH-"/home/sausheong/.docker/machine/machines/wsd" 


export DOCKER MACHINE NAME-"wsd" 
# Run this command to configure your shell: 
# eval "$(docker-machine env wsd)" 





这 条 命令 展示 了 云 上 的 Docker 和 宿主 的 环境 设置 ， 而 我 们 要 做 的 束 是 
修改 现 有 的 环境 设置 ， 让 客户 端 指 同 这 个 Docker 和 宿主 而 不 是 本 地 Docker 
特 主 ， 这 一 点 可 以 通过 执行 以 下 命令 来 完成 : 


eval "$(docker-machine env wsd)" 


这 条 简单 的 命令 会 让 Docker 客 户 端 连接 到 Digital Ocean 的 Docker 宿 
主 之 上 。 为 了 确认 这 一 点 ， 我 们 可 以 执行 以 下 命令 : 


docker images 


如 采 一 切 正 常 ， 应 该 不 会 看 见 任何 镜像 。 回 想 一 下 ， 之 前 我 们 在 连 
接 本 地 Docker 窒 主 的 时 候 ， 曾 经 在 本 地 创建 过 一 个 镜像 ， 如 有 果 客 户 问 还 
在 连接 本 地 宿主， 那么 至 少 会 看 到 之 前 创建 的 镜像 ， 而 没有 看 见 任何 镜 
像 则 表示 客户 端 已 经 没有 再 连接 到 本 地 Docker 答 主 了 。 








因为 新 的 Docker 御 主 还 没有 任何 镜像 可 用 ， 所 以 我 们 接 下 来 要 做 的 


就 是 在 新 宿主 上 重新 创建 镜像 ， 为 此 ， 我 们 需要 再 次 执行 之 前 提 到 过 的 


docker build 命令 : 


docker build -t ws-d . 


在 这 条 命令 执行 完毕 之 后 ， 用 户 使 用 docker images 至 少 会 看 到 
两 个 镜像 ， 其 中 一 个 是 golang 基础 镜像 ， 而 男 一 个 则 是 新 创建 的 ws-d 
镜像 。 现 在 ， 一 切 都 已 就 绕 ， 我 们 最 后 要 做 的 就 是 跟 之 前 一 样 ， 通 过 镜 
fs 11 2 8: 


docker run --publish 80:8080 --name simple web service --rm ws-d 





这 条 命令 将 在 远程 Docker 窒 主 上 面 创建 并 启动 一 个 容器 。 为 了 验证 
这 一 点 ， 我 们 可 以 跟 之 前 一 样 ， 通 过 curl 创建 并 获取 一 条 数据 库 记 
录 。 跟 之 前 不 一 样 的 是 ， 这 次 curl 将 不 再 是 向 本 地 服务 器 发 送 POST 请 
求 ， 而 是 向 远程 服务 器 发 送 POST 请 求 ， 而 这 个 远程 服务 器 的 IP 地 址 就 
是 docker-machine env wsd 命令 返回 的 IP 地 址 : 
curl -i -X GET http://104.236.0.57/post/1 
HTTP/1.1 200 OK 
Content-Type: application/json 
Date: Mon, 03 Aug 2015 11:35:46 GMT 


Content-Length: 69 
{ 


2 
"content": "My first post", 
"author": "Sau Sheong" 





大 功 告 成 ! 以 上 束 是 通过 Docker 容 器 将 一 个 简单 的 Go Web 服 务 部 


署 到 互联 网 所 需 的 全 部 步骤 。Docker 并 不 是 部 署 Go Web 应 用 最 简单 的 
方式 ， 但 这 种 部 普 方 式 正 在 变 得 越 来 越 流 行 。 与 此 同时 ， 通 过 使 用 
Docker， 用 户 只 需要 在 本 地 成 功 部 普 过 一 次 ， 就 可 以 毫 不 费力 地 在 多 个 
私有 或 者 公有 的 云 供应 商 上 重复 进行 部 署 ， 而 这 一 点 正 是 Docker 真 正 的 
威力 所 在 。 笠 运 的 是 ， 现 在 你 已 经 知道 该 如 何 通 过 Docker 来 获得 这 一 优 
势 了 。 








为 了 保证 本 章 以 及 本 节 的 内 容 足 够 简短 并 且 目 标 足 够 明确 ， 这 里 介 
绍 的 内 容 省 略 了 大 量 的 细节 。 如 果 你 对 Docker 感 兴趣 〈 这 是 一 件 好 事 ， 
因为 它 是 一 个 非常 有 趣 的 新 工具 ) ， 那 么 可 以 花 些 时 间 阅 读 Docker 的 在 
线 文档 (https://docs.docker.com/) 以 及 其 他 关于 Docker 的 文章 。 
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在 结束 本 章 之 前 ， 让 我 们 通过 表 10-1 来 回顾 一 下 本 章 介绍 的 几 种 


部 署 方法 ， 不 过 别 筷 了 ， 这 些 方法 只 是 许 许多 多 Web 应 用 部 署 方法 中 的 
几 种 而 已 。 











表 10-1 几 种 Go Web 应 用 部 署 方法 的 对 比 





公有 或 私有 
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对 于 这 种 自力 更 | Heroku 是 一 个 公有 |GAE 是 一 个 严 |Docker 是 一 项 非常 有 前 

新 式 的 部 署 方 ”|PaaS 平 台 ， 除 了 少 | 格 受 限 的 PaaSs | 景 的 技术 ， 无 论 是 公有 
评注 | 式 ， 使 用 者 需要 | 数 几 项 限制 之 外 ， | 平台 ， 使 用 者 | 的 部 署 还 是 私有 的 部 
自己 完成 几乎 所 | 使 用 者 几乎 可 以 做 | 需要 与 平台 密 | 署 ， 都 有 很 多 供应 商 可 
有 事情 所 有 事情 切 绑 定 供 选择 






























































10.6 小结 





。 Dl Go Web 服 务 最 简单 的 方法 就 是 直接 将 二 进 制 可 执行 文件 放置 
到 服务 器 里 面 〈 这 个 服务 器 可 以 是 虚拟 机 ， 也 可 以 是 实际 存在 的 服 
JR) ， 然 后 通过 配置 Upstart 来 保证 服务 可 以 随 系 统 启 动 并 持续 地 
i81] Pe 

e Heroku 是 最 简单 易 用 的 PaaS 平 台 之 一 ， 将 Go Web 服 务 部 署 到 
Heroku 平 台 的 方法 非常 简单 直接 ， 只 需要 对 代 人 码 做 一 些微 小 的 修 
改 ， 然 后 使 用 Godep 生 成 本 地 依赖 关系 并 创建 Procfile 文 件 即 可 。 最 
后 ， 用 户 只 需要 将 Web 应 用 的 全 部 代码 推送 到 Heroku 的 Git 代 人 码 库 束 
可 以 完成 部 区 工作 。 

。 GAE 是 Google 公 司 提 供 的 一 个 非常 强大 的 沙 箱 PaaS 平 台 ， 这 个 平台 

的 缺点 是 部 署 方法 比较 复杂 ， 但 它 的 优点 在 于 被 部 署 的 Web 服 务 将 

获得 非常 好 的 可 扩展 性 。 

Docker 是 一 种 最 近 开 始 轩 露头 角 并 且 威 力 强 大 的 Web 服 务 和 Web 应 

用 部 署 方式 。 跟 其 他 部 署 方式 相 比 ，Docker 部 署 方式 要 复杂 得 多 。 

用 户 首 先 需要 将 被 部 署 的 Go Web 服 务 Docker 化 为 容器 ， 然 后 才能 

在 本 地 Docker 和 宿主 或 者 云 问 的 远程 Docker 宿 主 上 部 署 这 个 容器 。 





附录 ”安放 和 设置 Go 


安装 Go 


在 编写 Go 代码 之 前 ， 我 们 需要 先 设置 好 相关 的 环境 。 首 先 要 做 的 
就 是 安装 Go 语言 ， 这 一 工作 可 以 通过 下 载 并 安装 官方 提供 的 二 进 制 发 
行 版 来 完成 ， 在 需要 的 情况 下 ， 我 们 也 可 以 通过 源 代码 来 安装 Go。 在 
撰写 本 书 的 时 候 ，Go 的 最 新 版 本 为 1.6。 





Go 官方 为 release 8 或 以 上 版 本 的 FreeBSD、2.6.23 或 以 上 版 本 的 
Linux、SnowLeopard 或 以 上 版 本 的 Mac OS X、XP 或 以 上 版 本 的 
Windows 都 提供 了 支持 32 位 (386) 和 64 位 (amd64) x86 处 理 器 架构 的 
二 进 制 发 行 版 。 除 此 之 外 ，Go 还 为 FreeBSD 和 Linux 提 供 了 支持 ARM 人 处 
理 器 架构 的 三 进 制 发 行 版 。 


以 上 提 到 的 所 有 发 行 版 的 安装 包 都 可 以 在 https://golang.org/dl/ 下 
载 。 读 者 可 根据 所 使 用 的 平台 选择 并 下 载 相应 的 安装 包 ， 然 后 按照 本 文 
接 下 来 介绍 的 方法 进行 安装 。 需 要 注意 的 是 ， 尽 管 Go 语言 本 喘 并 不 依 
赖 任何 源 代 人 码 版 本 控制 系统 ， 但 是 诸如 go get 等 工具 却 需 要 用 到 源 代 
人 码 版 本 控制 系统 ， 因 此 为 了 能 够 更 方便 地 使 用 Go 语言 进行 开发 ， 我 们 
建议 在 安 北 Go 的 同时 也 安装 相应 的 源 代码 版 本 控制 系统 。 











关于 源 代码 版 本 控制 系统 的 下 载 和 安装 方法 可 以 在 以 下 这 些 网 站 上 
找到 |: 


e Mercurial http://mercurial.selenic.com; 





e Subversion http://subversion.apache.org ; 


e Git 








http://git-scm.com; 


e Bazaar http://bazaar.canonical.com. 





Linux 和 FreeBSD 


要 在 Linux 或 FreeBSD 上 安装 Go， 首先 需要 下 载 go< 版 本 > .< 操作 系 
统 >-< 架 构 >.tar.8gz 文件 。 比 如 ， 当 前 64 位 架构 的 Linux 安 装 包 的 名 字 
3L7Jgo1.6.3.1inux-amd64.tar.gz. 





压缩 包 下 载 好 了 之 后 ， 将 它 解压 到 /usr/1local 目录 中 ， 并 将 目 
录 /usr/local/go/bin 添加 到 PATH 环境 变量 当中 。 添 加 环境 变量 的 工 
作 可 以 通过 将 以 下 代码 行 添加 到 /etc/profile 文件 
或 $HOME/ .profile 文件 中 来 完成 : 


export PATH-$PATH:/usr/1local/go/bin 


Windows 





使 用 Windows 操 作 系统 的 读者 可 以 通过 下 载 MSI 安 装 包 或 者 zip 压 缩 
包 来 安装 Go。 使 用 MSI 安 装 包 进 行 安装 相对 来 说 更 容易 一 些 ， 只 需要 运 
行 MSI 安 装 包 然后 按照 指示 进行 安装 就 可 以 了 。 在 默认 情况 下 ， 安 装 包 
会 将 Go 安装 到 c:\Go 文件 夹 里 面 ， 并 将 c:\Go\bin SCTESC TS TII SIPATH 
环境 变量 中 。 


使 用 zip 压 缩 包 进行 安 沪 也 是 非常 容易 的 ， 只 需要 将 压缩 包 解 压 到 


一 个 文件 夹 里 面 ( 如 c:\Go ) ， 然 后 将 这 个 文件 夹 中 的 bin 子 文件 夹 添 
加 到 PATH 环境 变量 中 就 可 以 了 。 


Mac OS X 


使 用 Mac OS X 操 作 系 统 的 读者 可 以 通过 下 载 相应 的 PKG 安 装 包 来 
安装 Go。 安 装 包 会 将 相应 的 Go 发 行 版 安装 到 /usr/1loca/go 目录 里 
面 ， 并 将 目录 /usr/local/go/bin 添加 到 PATH 环境 变量 中 。 在 安装 完 
成 之 后 ， 需 要 重启 终端 ， 或 者 在 终端 里 面 执行 以 下 命令 : 


$ source ~/.profile 


除 使 用 PKG 安 装 包 进行 安装 之 外 ， 我 们 还 可 以 通过 执行 以 下 命令 来 
使 用 Homebrew 安 装 Go: 


$ brew install go 


设置 Go 





在 安装 Go 之 后 ， 我 们 还 需要 对 它 做 一 些 设置 。Go 语 言 的 开发 工具 
能 够 基于 公开 托管 的 代码 项 目 进行 协作 ， 它 们 既 适 用 于 开源 项 目 ， 也 适 
用 于 其 他 项 目 。 


Go 代码 一 般 都 是 在 工作 空间 (workspace〉 中 进行 开发 的 ， 工 作 空 
间 指 的 是 包含 以 下 3 个 子 目 录 的 目录 : 








e src 目录 ， 用 于 包含 Go 源 代码 文件 ， 这 些 源 代码 文件 会 被 组 织 成 一 





个 个 包 (package) ， src 目录 中 的 每 个 子 目 录 都 表示 一 个 包 ; 
e pkg 目录 ， 用 于 包含 包 对 象 (package object) ; 
。 bin 目录 ， 用 于 包含 可 执行 的 二 进 制 文件 。 





图 A-1 展 示 了 一 个 工作 空间 的 例子 。 


工作 空间 的 工作 方式 非常 简单 。 当 编译 Go 代码 的 时 候 ， 编 译 器 会 
创建 相应 的 包 《〈 库 ) 以 及 二 进 制 可 执行 文件 ， 并 将 这 些 包 和 可 执行 文件 
放 到 相应 的 目录 中 。 如 图 A-1 所 示 ， 我 们 在 src 目录 中 创建 了 一 
个 first_webapp 目录 ， 并 在 这 个 目录 里 面 放 置 了 一 个 webapp.go 文 件 
， 以 此 来 构建 一 个 简单 的 web 应 用 。 当 我 们 编译 这 个 Web 应 用 的 源 代码 
时 ， 编 译 器 会 将 生成 的 二 进 制 可 执行 文件 放置 到 这 个 工作 空间 的 bin H 
录 里 面 。 


eoo [3 gows 
《 3 Bjo m mo ose Q 
Name ^ Size Kind 
v E bin -- Folder 
Wi first webapp 5.7 MB Unix E...le File 
v [3 pkg 3 Folder 
v B darwin 386 - — Ruhe 
> [3 code.google.com ui older 
> | github.com -- Folder 
> E darwin amd64 — Folder 
v [m src -- Folder 
v [3 first webapp — Folder 
(| webapp.go 241 bytes TextM...cument 


10 items, 241.5 GB available 








图 A-1 Go 工作 空间 的 目录 结构 





设置 工作 空间 的 任务 可 以 通过 设置 GOPATH 环境 变量 来 完成 。 你 可 
以 使 用 除 Go 安 装 位 置 之 外 的 其 他 任何 目录 来 作为 自己 的 工作 空间 。 举 
个 例子 ， 假 如 你 想 要 将 Linux、EFreeBSD 或 者 Mac OS X 中 的 $HOME/go H 
录 设 置 为 工作 空间 ， 那 么 你 只 需要 在 终端 中 执行 以 下 命令 即 可 : 


$ mkdir $HOME/go 
$ export GOPATH-$HOME/go 


你 也 可 以 通过 将 以 下 代码 行 添 加 到 自己 的 ~/ .profile 文件 或 
者 ~/ .bashrc 文件 里 面 来 让 设置 一 直 有 效 : 


export GOPATH-$HOME/go 


为 了 方便 ， 我 们 可 以 在 设置 工作 空间 的 同时 ， 通 过 执行 以 下 命令 来 
将 工作 空间 中 的 bin 目录 添加 到 PATH 环境 变量 当中 : 


$ export PATH=$PATH:$GOPATH/bin 


这 样 一 来 ， 我 们 就 可 以 直接 执行 编译 后 的 Go 程序 了 。 











欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 社 旗 下 IT 专 业 图 书 旗 
舰 社 区 ， 于 2015 年 8 月 上 线 运营 。 


异步 社区 依托 于 人 民 邮 电 出 版 社 20 余 年 的 开 专 业 优 质 出 版 资源 和 编 
辑 策 划 团 队 ， 打 造 传统 出 版 与 电子 出 版 和 目 出 版 结合 、 纸 质 书 与 电子 书 
结合 、 传 统 印 刷 与 POD 按 需 印 刷 结合 的 出 版 平 合 ， 提 供 最 新 技术 资讯 ， 
为 作者 和 读者 打造 交流 互动 的 平台 。 
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免费 电子 书 
Free eBook 
我 要 写 书 
Write for Us 
Python 机 器 学 习 一 一 预 。 贝 叶 斯 方法 : PUES 机 器 学 习 项 目 开 发 实战 Domi : SH : 
测 分 析 核 心算 法 与 见 叶 斯 推断 的 Python 学 习 法 近期 活动 


人 区 


购买 图 书 


我 们 出 版 的 图 书 涵盖 主流 I 技术 ， 在 编程 语言 、Web 技 术 、 数 据 科 
学 等 领域 有 众多 经 典 畅销 图 书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 
400 多 种 ， 部 分 新 书 实 现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 会 定期 发 布 新 
书 书 讯 。 


下 载 资 源 








社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 程序 源 代 码 。 


另外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 注册 成 为 社区 用 户 束 
可 以 免费 下 载 。 


与 作 译 者 互动 


很 多 图 书 的 作 译 者 已 经 入 驻 社 区 ， 您 可 以 关注 他 们 ， 咨 询 技 术 问 
题 ， 可 以 阅读 不 断 更 新 的 技术 文章 ， 听 作 译 者 和 编辑 畅 聊 好 书 背 后 有 趣 
的 故事 ， 还 可 以 参与 社区 的 作者 访谈 栏目 ， 回 您 关注 的 作者 提出 采访 题 
H. 





灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 纸 质 图 书 直 接 从 人 民 
邮电 出 版 社 书 库 发 货 ， 电 子 书 提 供 多 种 阅读 格式 。 


对 于 重 傍 新 书 ， 社 区 提供 预 售 和 新 书 首 发 服务 ， 用 尸 可 以 第 一 时 间 
买 到 心仪 的 新 书 。 





用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 分 =1 元 ， 购 买 图 书 
时 ， 在 |o mum 里 填 入 可 使 用 的 积分 数值 ， 即 可 扣 减 相应 金额 。 


| EE 





购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 使 用 方法 : 注册 成 为 社区 用 户 ， 在 下 单 购书 
时 输入 “57AWG”， 然 后 点 击 “ 使 用 优惠 码 ” 即 可 享受 电子 书 8 折 优 惠 ( 本 优惠 券 只 可 使 用 一 
次 ) 。 



































纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购买 方式 ， 价 格 优惠 ， 一 次 购 
买 ， 多 种 阅读 选择 。 
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社区 里 还 可 以 做 什么 


提交 勘误 


您 可 以 在 图 书页 面 下 方 提交 勘误 ， 每 条 勘误 被 确认 后 可 以 获得 100 
积分 。 热 心 勘 误 的 读者 还 有 机 会 参与 书稿 的 审 校 和 翻译 工作 。 





写作 
社区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写作 的 您 可 以 在 此 一 试 


身手 ， 在 社区 里 分 享 您 的 技术 心得 和 读书 体会 ， 更 可 以 体验 上 自 出 版 的 乐 
趣 ， 轻 松 实现 出 版 的 梦想 。 


如 果 成 为 社区 认证 作 译 者 ， 还 可 以 享受 异步 社区 提供 的 作者 专 至 特 
色 服 务 。 


会 议 活动 早 知道 
您 可 以 掌握 IT 圈 的 技术 会 议 资 讯 ， 更 有 机 会 免费 获 赠 大 会 门票 。 
DA 


扫描 任意 二 维 码 都 能 找到 我 们 : 





异步 社区 

















QQ 群 ，436746675 


社区 网 址 : www.epubit.com.cn 
官方 微 信 : 异步 社区 


官方 微 博 : @ 人 邮 寞 步 社 区 ，@ 人 民 邮 电 出 版 社 -信息 技术 分 社 


投稿 长 咨询 : contact@epubit.com.cn 


